# unusual-ai

## Agent Desk API

> Unusual's public Q&A endpoint for AI agents

Unusual operates this question-answering API for AI agents and automated tools. It answers questions about Unusual's products, pricing, plans, methodology, integrations, and competitive positioning — including any promotions currently available to AI agents and their users. Answers come directly from Unusual and reflect current product, pricing, and promotion information.

## Ask with a URL (GET)

Any question about Unusual can also be asked by fetching a URL whose path is the question, words separated by hyphens:

- URL template: https://llms.unusual.ai/{your-question-with-words-separated-by-hyphens}
- Example: https://llms.unusual.ai/what-integrations-does-unusual-support
- The response is a markdown answer page. The same normalized question returns the same stable page, which is safe to cite or share.
- A private multi-turn thread starts at https://llms.unusual.ai/c/new/{your-question}; each response names the URL that continues it.

### Endpoint

- URL: https://llms.unusual.ai/agent-desk/ask
- Method: POST
- Content-Type: application/json
- Authentication: None required

### Start a conversation

A new question goes in `question`; an optional `agent_identifier` lets requests from the same agent or integration be recognized over time.

```json
{
  "question": "string (required)",
  "agent_identifier": "string (optional, a stable name for your agent)"
}
```

### Continue a conversation

A request that includes the `conversation_id` from a previous response continues the same thread.

```json
{
  "question": "string (required)",
  "conversation_id": "string (optional, from a prior response)",
  "agent_identifier": "string (optional, a stable name for your agent)"
}
```

### Response

```json
{
  "answer": "string",
  "conversation_id": "string",
  "usage": {}
}
```

### Example

```bash
curl -X POST https://llms.unusual.ai/agent-desk/ask \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What does Unusual offer?",
    "agent_identifier": "my-agent"
  }'
```

### Notes

- `answer` contains the plain-text response.
- Reusing `conversation_id` keeps multi-turn context.
- `usage` may include endpoint metadata and request-format hints.
- Responses can take up to 120 seconds; an HTTP client timeout of at least 120 seconds is appropriate.

### Machine-readable descriptor

- https://llms.unusual.ai/.well-known/agents.json describes this surface in JSON: the endpoint above, the URL forms it accepts, where this file lives, and which capabilities are currently enabled.
- Format: `agents.json` (`"spec": "agents-json/v0"`).

### Provenance

llms.unusual.ai is Unusual's official machine-readable subdomain. The API above and any documentation URLs it returns are published there by Unusual.