GET /api/o/{token}
The pixel records the open and returns the GIF. Every failure is swallowed: an unknown token, a
database that is down, anything — the answer is still a 200 and a valid image. An email already in
an inbox must never display a broken picture because of an incident on our side.
Authorization
| Role in the organization | This endpoint |
|---|---|
OWNER | Allowed |
ADMIN | Allowed |
MEMBER | Allowed |
Path parameters
| Parameter | Type | Description |
|---|---|---|
token | string | Required. Opaque, per recipient and per send. It is generated for you and travels inside the email |
Example
bash
curl -i "https://www.agentsmail.io/api/o/$TOKEN"Response
200 OK— the call succeeded.401 Unauthorized— missing or invalid key, or its owner left the organization.404 Not Found— no such resource, or it belongs to another organization. The API never confirms that an id exists to a caller who has no right to it.429 Too Many Requests— over 120 requests in a minute for this key.