List endpoint events

GET

projects

{projectId}

endpoints

{id}

events

Together AI SDK (Python)

from together import Together

client = Together()
identity = client.whoami()
if identity.type != "project_api_key":
    raise RuntimeError("TOGETHER_API_KEY must be a project API key")
project_id = identity.project.id

events = client.endpoints.list_events(
    "ep_abc123",
    project_id=project_id,
    min_level="LEVEL_WARN",
)
for event in events:
    print(event)

import Together from "together-ai";

const client = new Together();
const identity = await client.whoami();
if (identity.type !== "project_api_key") {
  throw new Error("TOGETHER_API_KEY must be a project API key");
}
const projectId = identity.project.id;

const events = client.endpoints.listEvents("ep_abc123", {
  projectId,
  minLevel: "LEVEL_WARN",
});
for await (const event of events) {
  console.log(event);
}

import Together from "together-ai";

const client = new Together();
const identity = await client.whoami();
if (identity.type !== "project_api_key") {
  throw new Error("TOGETHER_API_KEY must be a project API key");
}
const projectId = identity.project.id;

const events = client.endpoints.listEvents("ep_abc123", {
  projectId,
  minLevel: "LEVEL_WARN",
});
for await (const event of events) {
  console.log(event);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.together.ai/v2/projects/{projectId}/endpoints/{id}/events",
  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>"
  ],
]);

$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.together.ai/v2/projects/{projectId}/endpoints/{id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.together.ai/v2/projects/{projectId}/endpoints/{id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "level": "LEVEL_DEBUG",
      "type": "<string>",
      "source": "<string>",
      "sourceKind": "SOURCE_KIND_ENDPOINT",
      "endpointId": "<string>",
      "message": "<string>",
      "deploymentId": "<string>",
      "subjectId": "<string>",
      "name": "<string>",
      "paths": [
        "<string>"
      ],
      "oldReplicas": 123,
      "newReplicas": 123,
      "version": 123,
      "status": "<string>",
      "reason": "<string>",
      "clusterId": "<string>",
      "serviceType": "<string>",
      "replicaId": "<string>",
      "containerName": "<string>",
      "logExcerpt": "<string>",
      "nodeId": "<string>"
    }
  ],
  "object": "list",
  "next_cursor": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": null,
    "code": null
  }
}

Authorizations

Authorization

string

header

default:default

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId

string

required

Project identifier.

string

required

Endpoint identifier.

Query Parameters

limit

integer

Maximum number of events to return. Max 10000, defaults to 50.

after

string

Cursor from a previous endpoint event list response.

types

string[]

Event types to include, such as deployment.scaled or condition.set. Combined with other filters using AND.

minLevel

enum<string>

Minimum severity. Omit to disable severity filtering.

Available options:

LEVEL_DEBUG,

LEVEL_INFO,

LEVEL_WARN,

LEVEL_ERROR

since

string<date-time>

Return only events at or after this time.

until

string<date-time>

Return only events strictly before this time.

deploymentIds

string[]

Deployment IDs whose events should be included. Every ID must belong to the endpoint. Supplying this filter excludes endpoint-scoped events unless SOURCE_KIND_ENDPOINT is also included in sourceKinds.

sourceKinds

enum<string>[]

Resource kinds whose events should be included. Omit to include both endpoint- and deployment-scoped events.

Available options:

SOURCE_KIND_ENDPOINT,

SOURCE_KIND_DEPLOYMENT

subjectId

string

ID of a subject associated with the event, such as a rollout. Combined with other filters using AND.

Response

Endpoint and deployment lifecycle events, ordered newest first.

data

object[]

required

Events for the endpoint, newest first.

Show child attributes

object

any

required

Object type. Always list.

next_cursor

string

Cursor for the next page. Null if there are no more results.

⌘I

Together AI SDK (Python)

from together import Together

client = Together()
identity = client.whoami()
if identity.type != "project_api_key":
    raise RuntimeError("TOGETHER_API_KEY must be a project API key")
project_id = identity.project.id

events = client.endpoints.list_events(
    "ep_abc123",
    project_id=project_id,
    min_level="LEVEL_WARN",
)
for event in events:
    print(event)

import Together from "together-ai";

const client = new Together();
const identity = await client.whoami();
if (identity.type !== "project_api_key") {
  throw new Error("TOGETHER_API_KEY must be a project API key");
}
const projectId = identity.project.id;

const events = client.endpoints.listEvents("ep_abc123", {
  projectId,
  minLevel: "LEVEL_WARN",
});
for await (const event of events) {
  console.log(event);
}

import Together from "together-ai";

const client = new Together();
const identity = await client.whoami();
if (identity.type !== "project_api_key") {
  throw new Error("TOGETHER_API_KEY must be a project API key");
}
const projectId = identity.project.id;

const events = client.endpoints.listEvents("ep_abc123", {
  projectId,
  minLevel: "LEVEL_WARN",
});
for await (const event of events) {
  console.log(event);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.together.ai/v2/projects/{projectId}/endpoints/{id}/events",
  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>"
  ],
]);

$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.together.ai/v2/projects/{projectId}/endpoints/{id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.together.ai/v2/projects/{projectId}/endpoints/{id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "level": "LEVEL_DEBUG",
      "type": "<string>",
      "source": "<string>",
      "sourceKind": "SOURCE_KIND_ENDPOINT",
      "endpointId": "<string>",
      "message": "<string>",
      "deploymentId": "<string>",
      "subjectId": "<string>",
      "name": "<string>",
      "paths": [
        "<string>"
      ],
      "oldReplicas": 123,
      "newReplicas": 123,
      "version": 123,
      "status": "<string>",
      "reason": "<string>",
      "clusterId": "<string>",
      "serviceType": "<string>",
      "replicaId": "<string>",
      "containerName": "<string>",
      "logExcerpt": "<string>",
      "nodeId": "<string>"
    }
  ],
  "object": "list",
  "next_cursor": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": null,
    "code": null
  }
}

TOGETHER APIS

SDK LIBRARIES

ERROR CODES

Authorizations

Path Parameters

Query Parameters

Response