Sessions and activity
Upload many session records
Upload many session records
curl --request POST \
--url https://api.atlan.com/agent/v1/sessions/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"name": "<string>",
"workspace_id": "<string>",
"subject_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_type": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"display_name": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"agent_provider_id": "<string>",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"message_count": 123,
"model_id": "<string>",
"remote_session_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_name": "<string>"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
name: '<string>',
workspace_id: '<string>',
subject_id: '<string>',
source_created_at: '<string>',
source_created_by: '<string>',
source_id: '<string>',
source_last_modified_at: '<string>',
source_last_modified_by: '<string>',
source_metadata: '<unknown>',
source_synced_at: '<string>',
source_type: '<string>',
source_uri: '<string>',
source_version: '<string>',
display_name: '<string>',
owner_id: '<string>',
project_id: '<string>',
repo_id: '<string>',
agent_provider_id: '<string>',
environment_id: '<string>',
error: '<string>',
external_session_id: '<string>',
message_count: 123,
model_id: '<string>',
remote_session_id: '<string>',
stop_reason: '<string>',
title: '<string>',
usage: {
cache_creation_input_tokens: 123,
cache_read_input_tokens: 123,
input_tokens: 123,
output_tokens: 123,
total_tokens: 123
},
visitor_email: '<string>',
visitor_external_id: '<string>',
visitor_id: '<string>',
visitor_identity_source: '<string>',
visitor_name: '<string>'
}
]
})
};
fetch('https://api.atlan.com/agent/v1/sessions/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.atlan.com/agent/v1/sessions/bulk"
payload = { "items": [
{
"name": "<string>",
"workspace_id": "<string>",
"subject_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_type": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"display_name": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"agent_provider_id": "<string>",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"message_count": 123,
"model_id": "<string>",
"remote_session_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_name": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"index": 1,
"status_code": 1,
"error": {
"code": "<string>",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
},
"session": {
"artifact_status": "<string>",
"commit_ts": "<string>",
"created_at": "<string>",
"created_by": "<string>",
"id": "<string>",
"is_latest": true,
"kind": "<string>",
"name": "<string>",
"source_type": "<string>",
"updated_at": "<string>",
"updated_by": "<string>",
"version_ordinal": 123,
"workspace_id": "<string>",
"session_status": "running",
"subject_id": "<string>",
"subject_kind": "harness",
"app": "<string>",
"content_hash_hex": "<string>",
"display_name": "<string>",
"etag": "<string>",
"identity": {
"client_id": "<string>",
"credential_kind": "<string>",
"api_key": "<string>",
"api_key_expires_at": "<string>",
"client_secret": "<string>"
},
"oidc_client_id": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_digest": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"version_label": "<string>",
"acting_agent_id": "<string>",
"agent_provider_id": "<string>",
"agent_provider_type": "local",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"is_subject_system": true,
"message_count": 123,
"model_id": "<string>",
"on_behalf_of_user_id": "<string>",
"remote_session_id": "<string>",
"session_vault_cli_credential_id": "<string>",
"session_vault_id": "<string>",
"session_vault_mcp_credential_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_link_status": "unlinked",
"visitor_name": "<string>",
"visitor_type": "human",
"visitor_user_id": "<string>",
"permissions": {},
"relationships": {
"count": 1,
"incoming": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>"
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>"
},
"weight": 123
}
],
"outgoing": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>"
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>"
},
"weight": 123
}
]
}
}
}
]
}{
"code": "invalid_base64",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "alg_mismatch",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "access_denied",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "compressed_payload_too_large",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "unsupported_content_encoding",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "validation_failed",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "internal_error",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "auth_unavailable",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "request_timeout",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Available options:
base64, gzip, base64 Body
application/json
Show child attributes
Show child attributes
Response
HTTP 207 response.
Show child attributes
Show child attributes
⌘I
Upload many session records
curl --request POST \
--url https://api.atlan.com/agent/v1/sessions/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"name": "<string>",
"workspace_id": "<string>",
"subject_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_type": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"display_name": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"agent_provider_id": "<string>",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"message_count": 123,
"model_id": "<string>",
"remote_session_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_name": "<string>"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
name: '<string>',
workspace_id: '<string>',
subject_id: '<string>',
source_created_at: '<string>',
source_created_by: '<string>',
source_id: '<string>',
source_last_modified_at: '<string>',
source_last_modified_by: '<string>',
source_metadata: '<unknown>',
source_synced_at: '<string>',
source_type: '<string>',
source_uri: '<string>',
source_version: '<string>',
display_name: '<string>',
owner_id: '<string>',
project_id: '<string>',
repo_id: '<string>',
agent_provider_id: '<string>',
environment_id: '<string>',
error: '<string>',
external_session_id: '<string>',
message_count: 123,
model_id: '<string>',
remote_session_id: '<string>',
stop_reason: '<string>',
title: '<string>',
usage: {
cache_creation_input_tokens: 123,
cache_read_input_tokens: 123,
input_tokens: 123,
output_tokens: 123,
total_tokens: 123
},
visitor_email: '<string>',
visitor_external_id: '<string>',
visitor_id: '<string>',
visitor_identity_source: '<string>',
visitor_name: '<string>'
}
]
})
};
fetch('https://api.atlan.com/agent/v1/sessions/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.atlan.com/agent/v1/sessions/bulk"
payload = { "items": [
{
"name": "<string>",
"workspace_id": "<string>",
"subject_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_type": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"display_name": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"agent_provider_id": "<string>",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"message_count": 123,
"model_id": "<string>",
"remote_session_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_name": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"index": 1,
"status_code": 1,
"error": {
"code": "<string>",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
},
"session": {
"artifact_status": "<string>",
"commit_ts": "<string>",
"created_at": "<string>",
"created_by": "<string>",
"id": "<string>",
"is_latest": true,
"kind": "<string>",
"name": "<string>",
"source_type": "<string>",
"updated_at": "<string>",
"updated_by": "<string>",
"version_ordinal": 123,
"workspace_id": "<string>",
"session_status": "running",
"subject_id": "<string>",
"subject_kind": "harness",
"app": "<string>",
"content_hash_hex": "<string>",
"display_name": "<string>",
"etag": "<string>",
"identity": {
"client_id": "<string>",
"credential_kind": "<string>",
"api_key": "<string>",
"api_key_expires_at": "<string>",
"client_secret": "<string>"
},
"oidc_client_id": "<string>",
"owner_id": "<string>",
"project_id": "<string>",
"repo_id": "<string>",
"source_created_at": "<string>",
"source_created_by": "<string>",
"source_digest": "<string>",
"source_id": "<string>",
"source_last_modified_at": "<string>",
"source_last_modified_by": "<string>",
"source_metadata": "<unknown>",
"source_synced_at": "<string>",
"source_uri": "<string>",
"source_version": "<string>",
"version_label": "<string>",
"acting_agent_id": "<string>",
"agent_provider_id": "<string>",
"agent_provider_type": "local",
"environment_id": "<string>",
"error": "<string>",
"external_session_id": "<string>",
"is_subject_system": true,
"message_count": 123,
"model_id": "<string>",
"on_behalf_of_user_id": "<string>",
"remote_session_id": "<string>",
"session_vault_cli_credential_id": "<string>",
"session_vault_id": "<string>",
"session_vault_mcp_credential_id": "<string>",
"stop_reason": "<string>",
"title": "<string>",
"usage": {
"cache_creation_input_tokens": 123,
"cache_read_input_tokens": 123,
"input_tokens": 123,
"output_tokens": 123,
"total_tokens": 123
},
"visitor_email": "<string>",
"visitor_external_id": "<string>",
"visitor_id": "<string>",
"visitor_identity_source": "<string>",
"visitor_link_status": "unlinked",
"visitor_name": "<string>",
"visitor_type": "human",
"visitor_user_id": "<string>",
"permissions": {},
"relationships": {
"count": 1,
"incoming": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>"
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>"
},
"weight": 123
}
],
"outgoing": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>"
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>"
},
"weight": 123
}
]
}
}
}
]
}{
"code": "invalid_base64",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "alg_mismatch",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "access_denied",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "compressed_payload_too_large",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "unsupported_content_encoding",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "validation_failed",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "internal_error",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "auth_unavailable",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}{
"code": "request_timeout",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>"
}