Overview

The Agents v1 API exposes a remote-model-compatible surface for discovering agent-backed models, listing deferred tools, activating tools for a session, and retrieving completed responses. It mirrors the shape expected by remote-model clients so that Allternit agents can be consumed through standard SDKs while still preserving Allternit-specific profile metadata.

Base URL

For local development:

Authentication

All routes require a valid bearer token in the Authorization header. See Authentication for details.

Agent profile object

A remote model entry returned by this API wraps an Allternit agent profile.

Endpoints

List agent-backed models

Response

Retrieve a model

Returns a single model object identical to the items returned by the list endpoint.

List tools

Response

Search tools

Filters the model’s available tools by id, label, or description.

Activate tools

Activate one or more tools for a session so they appear in the runtime tool snapshot.

Response

Retrieve a response

Fetch a previously generated assistant response by its response ID.

Response

Error codes