---
name: openrouter-api
description: "OpenRouter API skill. Use when working with OpenRouter for responses, messages, activity. Covers 39 endpoints."
version: 1.0.0
generator: lapsh
---

# OpenRouter API
API version: 1.0.0

## Auth
Bearer bearer | Bearer bearer

## Base URL
https://openrouter.ai/api/v1

## Setup
1. Set Authorization header with Bearer token
2. GET /activity -- get user activity grouped by endpoint
3. POST /responses -- create first response

## Endpoints
39 endpoints across 16 groups. See references/api-spec.lap for full details.

### Responses
| Method | Path | Description |
|--------|------|-------------|
| POST | /responses | Create a response |

### Messages
| Method | Path | Description |
|--------|------|-------------|
| POST | /messages | Create a message |

### Activity
| Method | Path | Description |
|--------|------|-------------|
| GET | /activity | Get user activity grouped by endpoint |

### Chat
| Method | Path | Description |
|--------|------|-------------|
| POST | /chat/completions | Create a chat completion |

### Credits
| Method | Path | Description |
|--------|------|-------------|
| GET | /credits | Get remaining credits |
| POST | /credits/coinbase | Deprecated Coinbase Commerce charge endpoint |

### Generation
| Method | Path | Description |
|--------|------|-------------|
| GET | /generation | Get request & usage metadata for a generation |

### Models
| Method | Path | Description |
|--------|------|-------------|
| GET | /models/count | Get total count of available models |
| GET | /models | List all models and their properties |
| GET | /models/user | List models filtered by user provider preferences, privacy settings, and guardrails |
| GET | /models/{author}/{slug}/endpoints | List all endpoints for a model |

### Endpoints
| Method | Path | Description |
|--------|------|-------------|
| GET | /endpoints/zdr | Preview the impact of ZDR on the available endpoints |

### Providers
| Method | Path | Description |
|--------|------|-------------|
| GET | /providers | List all providers |

### Keys
| Method | Path | Description |
|--------|------|-------------|
| GET | /keys | List API keys |
| POST | /keys | Create a new API key |
| PATCH | /keys/{hash} | Update an API key |
| DELETE | /keys/{hash} | Delete an API key |
| GET | /keys/{hash} | Get a single API key |

### Organization
| Method | Path | Description |
|--------|------|-------------|
| GET | /organization/members | List organization members |

### Guardrails
| Method | Path | Description |
|--------|------|-------------|
| GET | /guardrails | List guardrails |
| POST | /guardrails | Create a guardrail |
| GET | /guardrails/{id} | Get a guardrail |
| PATCH | /guardrails/{id} | Update a guardrail |
| DELETE | /guardrails/{id} | Delete a guardrail |
| GET | /guardrails/assignments/keys | List all key assignments |
| GET | /guardrails/assignments/members | List all member assignments |
| GET | /guardrails/{id}/assignments/keys | List key assignments for a guardrail |
| POST | /guardrails/{id}/assignments/keys | Bulk assign keys to a guardrail |
| GET | /guardrails/{id}/assignments/members | List member assignments for a guardrail |
| POST | /guardrails/{id}/assignments/members | Bulk assign members to a guardrail |
| POST | /guardrails/{id}/assignments/keys/remove | Bulk unassign keys from a guardrail |
| POST | /guardrails/{id}/assignments/members/remove | Bulk unassign members from a guardrail |

### Key
| Method | Path | Description |
|--------|------|-------------|
| GET | /key | Get current API key |

### Auth
| Method | Path | Description |
|--------|------|-------------|
| POST | /auth/keys | Exchange authorization code for API key |
| POST | /auth/keys/code | Create authorization code |

### Embeddings
| Method | Path | Description |
|--------|------|-------------|
| POST | /embeddings | Submit an embedding request |
| GET | /embeddings/models | List all embeddings models |

### Rerank
| Method | Path | Description |
|--------|------|-------------|
| POST | /rerank | Submit a rerank request |
| GET | /rerank/models | List all rerank models |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a response?" -> POST /responses
- "Create a message?" -> POST /messages
- "List all activity?" -> GET /activity
- "Create a completion?" -> POST /chat/completions
- "List all credits?" -> GET /credits
- "Create a coinbase?" -> POST /credits/coinbase
- "List all generation?" -> GET /generation
- "List all count?" -> GET /models/count
- "List all models?" -> GET /models
- "List all user?" -> GET /models/user
- "List all endpoints?" -> GET /models/{author}/{slug}/endpoints
- "List all zdr?" -> GET /endpoints/zdr
- "List all providers?" -> GET /providers
- "List all keys?" -> GET /keys
- "Create a key?" -> POST /keys
- "Partially update a key?" -> PATCH /keys/{hash}
- "Delete a key?" -> DELETE /keys/{hash}
- "Get key details?" -> GET /keys/{hash}
- "List all members?" -> GET /organization/members
- "List all guardrails?" -> GET /guardrails
- "Create a guardrail?" -> POST /guardrails
- "Get guardrail details?" -> GET /guardrails/{id}
- "Partially update a guardrail?" -> PATCH /guardrails/{id}
- "Delete a guardrail?" -> DELETE /guardrails/{id}
- "Create a member?" -> POST /guardrails/{id}/assignments/members
- "Create a remove?" -> POST /guardrails/{id}/assignments/keys/remove
- "List all key?" -> GET /key
- "Create a code?" -> POST /auth/keys/code
- "Create a embedding?" -> POST /embeddings
- "Create a rerank?" -> POST /rerank
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)