cURL
curl --request GET \
--url https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId} \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <tenant-name>'import { CortiClient, CortiEnvironment } from "@corti/sdk";
const client = new CortiClient({
environment: CortiEnvironment.Eu,
auth: {
clientId: "YOUR_CLIENT_ID",
clientSecret: "YOUR_CLIENT_SECRET"
},
tenantName: "YOUR_TENANT_NAME"
});
await client.agents.getContext("12345678-90ab-cdef-gh12-34567890abc", "contextId");using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agents.GetContextAsync(
"12345678-90ab-cdef-gh12-34567890abc",
"contextId",
new AgentsGetContextRequest()
);import requests
url = "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}"
headers = {
"Tenant-Name": "<tenant-name>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Tenant-Name: <tenant-name>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tenant-Name", "<tenant-name>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}")
.header("Tenant-Name", "<tenant-name>")
.header("Authorization", "Bearer <token>")
.asString();{
"id": "<string>",
"items": [
{
"id": "<string>",
"contextId": "<string>",
"status": {
"message": {
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"messageId": "<string>",
"kind": "message",
"metadata": {},
"extensions": [
"<string>"
],
"referenceTaskIds": [
"<string>"
],
"taskId": "<string>",
"contextId": "<string>"
},
"timestamp": "2023-11-07T05:31:56Z"
},
"kind": "task",
"history": [
{
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"messageId": "<string>",
"kind": "message",
"metadata": {},
"extensions": [
"<string>"
],
"referenceTaskIds": [
"<string>"
],
"taskId": "<string>",
"contextId": "<string>"
}
],
"artifacts": [
{
"artifactId": "<string>",
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"name": "<string>",
"description": "<string>",
"metadata": {},
"extensions": [
"<string>"
]
}
],
"metadata": {}
}
]
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}Agents
Get Context by ID
This endpoint retrieves all tasks and top-level messages associated with a specific context for the given agent.
GET
/
agents
/
{id}
/
v1
/
contexts
/
{contextId}
cURL
curl --request GET \
--url https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId} \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <tenant-name>'import { CortiClient, CortiEnvironment } from "@corti/sdk";
const client = new CortiClient({
environment: CortiEnvironment.Eu,
auth: {
clientId: "YOUR_CLIENT_ID",
clientSecret: "YOUR_CLIENT_SECRET"
},
tenantName: "YOUR_TENANT_NAME"
});
await client.agents.getContext("12345678-90ab-cdef-gh12-34567890abc", "contextId");using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agents.GetContextAsync(
"12345678-90ab-cdef-gh12-34567890abc",
"contextId",
new AgentsGetContextRequest()
);import requests
url = "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}"
headers = {
"Tenant-Name": "<tenant-name>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Tenant-Name: <tenant-name>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tenant-Name", "<tenant-name>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.{environment}.corti.app/agents/{id}/v1/contexts/{contextId}")
.header("Tenant-Name", "<tenant-name>")
.header("Authorization", "Bearer <token>")
.asString();{
"id": "<string>",
"items": [
{
"id": "<string>",
"contextId": "<string>",
"status": {
"message": {
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"messageId": "<string>",
"kind": "message",
"metadata": {},
"extensions": [
"<string>"
],
"referenceTaskIds": [
"<string>"
],
"taskId": "<string>",
"contextId": "<string>"
},
"timestamp": "2023-11-07T05:31:56Z"
},
"kind": "task",
"history": [
{
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"messageId": "<string>",
"kind": "message",
"metadata": {},
"extensions": [
"<string>"
],
"referenceTaskIds": [
"<string>"
],
"taskId": "<string>",
"contextId": "<string>"
}
],
"artifacts": [
{
"artifactId": "<string>",
"parts": [
{
"kind": "text",
"text": "<string>",
"metadata": {}
}
],
"name": "<string>",
"description": "<string>",
"metadata": {},
"extensions": [
"<string>"
]
}
],
"metadata": {}
}
]
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.
Example:
"base"
Path Parameters
The identifier of the agent associated with the context.
Example:
"12345678-90ab-cdef-gh12-34567890abc"
The identifier of the context (thread) to retrieve tasks for.
Query Parameters
The maximum number of tasks and messages to return. If not specified all history is returned.
The number of tasks and messages to skip before starting to collect the result set. Default is 0.
Was this page helpful?
⌘I