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>",
"is_private": true,
"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>',
is_private: true,
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>",
"is_private": True,
"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>",
"current_releases": {},
"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>",
"uri": "<string>",
"version_label": "<string>",
"write_index": 123,
"acting_agent_id": "<string>",
"agent_provider_id": "<string>",
"agent_provider_type": "local",
"environment_id": "<string>",
"error": "<string>",
"execution": {
"revision": 1,
"status": {
"last_seq": 123,
"last_user_seq": 123,
"phase": "preparing",
"session_id": "<string>",
"turn": 1,
"error_code": "<string>",
"pending": 1,
"stop_reason": "end_turn",
"usage": {
"input_tokens": 123,
"model_calls": 1,
"output_tokens": 123,
"tool_calls": 1,
"total_tokens": 123
},
"wait_until_ms": 1
},
"harness": {
"state_id": "<string>",
"version": 1,
"summary_id": "<string>",
"summary_through_seq": 123,
"wait_until_ms": 1
}
},
"external_session_id": "<string>",
"is_private": true,
"is_subject_system": true,
"launch_id": "<string>",
"launch_status": "pending",
"message_count": 123,
"model_id": "<string>",
"on_behalf_of_user_id": "<string>",
"origin": "schedule",
"recovery": {
"reason": "workflow_missing",
"state": "unknown"
},
"release": {
"release_id": "<string>",
"version_id": "<string>",
"content_hash": "<string>",
"version_ordinal": 123
},
"remote_session_id": "<string>",
"run_as_user_id": "<string>",
"session_vault_cli_credential_id": "<string>",
"session_vault_id": "<string>",
"session_vault_mcp_credential_id": "<string>",
"stop_reason": "<string>",
"surface": {
"admission_event_id": "<string>",
"binding_id": "<string>",
"channel_id": "<string>",
"requester": {
"display_name": "<string>",
"slack_team_id": "<string>",
"slack_user_id": "<string>"
},
"root_ts": "<string>",
"team_id": "<string>",
"personal_for": "<string>",
"predecessor_session_id": "<string>"
},
"title": "<string>",
"trigger_id": "<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>",
"is_readable": true
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"weight": 123
}
],
"outgoing": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"weight": 123
}
]
}
}
}
]
}{
"code": "invalid_base64",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>",
"allowed_values": [
"<string>"
],
"field": "<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>",
"allowed_values": [
"<string>"
],
"field": "<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
⌘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>",
"is_private": true,
"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>',
is_private: true,
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>",
"is_private": True,
"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>",
"current_releases": {},
"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>",
"uri": "<string>",
"version_label": "<string>",
"write_index": 123,
"acting_agent_id": "<string>",
"agent_provider_id": "<string>",
"agent_provider_type": "local",
"environment_id": "<string>",
"error": "<string>",
"execution": {
"revision": 1,
"status": {
"last_seq": 123,
"last_user_seq": 123,
"phase": "preparing",
"session_id": "<string>",
"turn": 1,
"error_code": "<string>",
"pending": 1,
"stop_reason": "end_turn",
"usage": {
"input_tokens": 123,
"model_calls": 1,
"output_tokens": 123,
"tool_calls": 1,
"total_tokens": 123
},
"wait_until_ms": 1
},
"harness": {
"state_id": "<string>",
"version": 1,
"summary_id": "<string>",
"summary_through_seq": 123,
"wait_until_ms": 1
}
},
"external_session_id": "<string>",
"is_private": true,
"is_subject_system": true,
"launch_id": "<string>",
"launch_status": "pending",
"message_count": 123,
"model_id": "<string>",
"on_behalf_of_user_id": "<string>",
"origin": "schedule",
"recovery": {
"reason": "workflow_missing",
"state": "unknown"
},
"release": {
"release_id": "<string>",
"version_id": "<string>",
"content_hash": "<string>",
"version_ordinal": 123
},
"remote_session_id": "<string>",
"run_as_user_id": "<string>",
"session_vault_cli_credential_id": "<string>",
"session_vault_id": "<string>",
"session_vault_mcp_credential_id": "<string>",
"stop_reason": "<string>",
"surface": {
"admission_event_id": "<string>",
"binding_id": "<string>",
"channel_id": "<string>",
"requester": {
"display_name": "<string>",
"slack_team_id": "<string>",
"slack_user_id": "<string>"
},
"root_ts": "<string>",
"team_id": "<string>",
"personal_for": "<string>",
"predecessor_session_id": "<string>"
},
"title": "<string>",
"trigger_id": "<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>",
"is_readable": true
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"weight": 123
}
],
"outgoing": [
{
"direction": "<string>",
"provenance": "<string>",
"rel_type": "<string>",
"relationship_status": "<string>",
"attributes": {},
"confidence": 123,
"from": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"label": "<string>",
"role": "<string>",
"to": {
"id": "<string>",
"kind": "<string>",
"is_readable": true
},
"weight": 123
}
]
}
}
}
]
}{
"code": "invalid_base64",
"detail": "<string>",
"status": 1,
"title": "<string>",
"trace_id": "<string>",
"allowed_values": [
"<string>"
],
"field": "<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>",
"allowed_values": [
"<string>"
],
"field": "<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>"
}