# Lockally Agents API

**Canonical:** https://apis.io/apis/lockally-com/lockally-com-agents-api/  
**Provider:** Lockally — https://apis.io/providers/lockally-com/  
**Base URL:** https://api.lockally.com  
**Documentation:** https://developers.lockally.com

Lockally Agents API is one of 30 APIs that [Lockally](https://apis.io/providers/lockally-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification.

AI-native agent surface: inboxes, threads, drafts, grants (per-mailbox authorization)

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/auth/whoami` | Introspect the calling credentials |
| GET | `/v1/inboxes` | List granted inboxes |
| GET | `/v1/contacts/lookup` | Who is this sender? |
| GET | `/v1/inboxes/{mailbox}/threads` | List conversation threads |
| POST | `/v1/inboxes/{mailbox}/messages` | Start a new conversation (agent stream) |
| GET | `/v1/threads/{threadID}` | Get a whole conversation |
| POST | `/v1/threads/{threadID}/reply` | Reply in-thread (agent stream) |
| GET | `/v1/threads/{threadID}/messages/{messageID}` | Get one message with body |
| POST | `/v1/threads/{threadID}/messages/{messageID}/read` | Mark read/unread |
| GET | `/v1/threads/{threadID}/messages/{messageID}/attachments/{idx}` | Download an attachment |
| GET | `/v1/api-keys/{keyID}/mailboxes` | List a key's mailbox grants |
| POST | `/v1/api-keys/{keyID}/mailboxes` | Grant a mailbox to a key |
| DELETE | `/v1/api-keys/{keyID}/mailboxes/{mailboxID}` | Revoke a mailbox grant |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/lockally-com/openapi/lockally-com-agents-api-openapi.yml

## Other Lockally APIs (12)

- [Lockally Add Ons API](https://apis.io/apis/lockally-com/lockally-com-add-ons-api/)
- [Lockally Admin API](https://apis.io/apis/lockally-com/lockally-com-admin-api/)
- [Lockally Admins API](https://apis.io/apis/lockally-com/lockally-com-admins-api/)
- [Lockally AI API](https://apis.io/apis/lockally-com/lockally-com-ai-api/)
- [Lockally Aliases API](https://apis.io/apis/lockally-com/lockally-com-aliases-api/)
- [Lockally API Keys API](https://apis.io/apis/lockally-com/lockally-com-api-keys-api/)
- [Lockally Billing API](https://apis.io/apis/lockally-com/lockally-com-billing-api/)
- [Lockally Calendars API](https://apis.io/apis/lockally-com/lockally-com-calendars-api/)
- [Lockally Contact Lists API](https://apis.io/apis/lockally-com/lockally-com-contact-lists-api/)
- [Lockally Contacts API](https://apis.io/apis/lockally-com/lockally-com-contacts-api/)
- [Lockally Dashboard API](https://apis.io/apis/lockally-com/lockally-com-dashboard-api/)
- [Lockally Directory API](https://apis.io/apis/lockally-com/lockally-com-directory-api/)

## Tags

Agents

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/lockally-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lockally-com/lockally-com-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lockally-com/.
