curl https://api.gork.email/v1/inboxes/inb_728af980b4e \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const inbox = await gork.inboxes.get("inb_728af980b4e")
import requests, os
res = requests.get(
"https://api.gork.email/v1/inboxes/inb_728af980b4e",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "inb_728af980b4e",
"organizationId": "org_1a2b3c4d",
"agentId": null,
"address": "support@try.gork.email",
"name": "support",
"isActive": true,
"deletedAt": null,
"createdAt": "2026-09-07T12:00:00.000Z",
"updatedAt": "2026-09-07T12:00:00.000Z"
}
}
Inboxes
Get Inbox
Fetch a single inbox by ID, scoped to your organization.
GET
/
v1
/
inboxes
/
{id}
curl https://api.gork.email/v1/inboxes/inb_728af980b4e \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const inbox = await gork.inboxes.get("inb_728af980b4e")
import requests, os
res = requests.get(
"https://api.gork.email/v1/inboxes/inb_728af980b4e",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "inb_728af980b4e",
"organizationId": "org_1a2b3c4d",
"agentId": null,
"address": "support@try.gork.email",
"name": "support",
"isActive": true,
"deletedAt": null,
"createdAt": "2026-09-07T12:00:00.000Z",
"updatedAt": "2026-09-07T12:00:00.000Z"
}
}
Returns the full record for one inbox in your organization.
Headers
string
required
Bearer token formatted as
Bearer gork_live_.... Requires the inboxes:read scope.Path parameters
string
required
The inbox ID (
inb_...).Inbox-bound agent keys may only fetch their own inbox — any other ID returns
403 inbox_access_denied.Response
object
Show properties
Show properties
string
Unique inbox ID (
inb_...).string
The organization that owns this inbox.
string
Linked agent ID, or
null when unassigned.string
Full email address (e.g.
support@try.gork.email).string
Display name for the inbox.
boolean
false once the inbox has been deactivated.string
Deactivation timestamp, or
null for active inboxes.string
ISO 8601 creation timestamp.
string
ISO 8601 last-update timestamp.
curl https://api.gork.email/v1/inboxes/inb_728af980b4e \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const inbox = await gork.inboxes.get("inb_728af980b4e")
import requests, os
res = requests.get(
"https://api.gork.email/v1/inboxes/inb_728af980b4e",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "inb_728af980b4e",
"organizationId": "org_1a2b3c4d",
"agentId": null,
"address": "support@try.gork.email",
"name": "support",
"isActive": true,
"deletedAt": null,
"createdAt": "2026-09-07T12:00:00.000Z",
"updatedAt": "2026-09-07T12:00:00.000Z"
}
}
| Code | HTTP | Meaning |
|---|---|---|
inbox_access_denied | 403 | The key is bound to a different inbox and cannot read this one. |
inbox_not_found | 404 | No inbox with this ID exists in your organization. |