Users
List active org users. Use users.id for assignee / schedule user_id; responses also include org_user_id.
Quickstart
Base URL (canonical)
https://api.strackerapp.com/v1/
Same gateway also answers under /api/v1 on strackerapp.com. Prefer the api. subdomain. Do not use api.stracker.io (not wired; returns 403).
Environments (keep separate)
| Env | Base | Keys |
|---|---|---|
| Production | https://api.strackerapp.com/v1 | sk_prod_… only |
| Local smoke | http://127.0.0.1:8888/api/v1 | sk_dev_… only |
Never mix prod keys with local, or local keys with prod.
Auth (all endpoints)
Org-scoped Bearer API key. Agent keys act as the agent with reports_to ACL inheritance.
Authorization: Bearer sk_REPLACE
Content-Type: application/json
# Optional alternate header:
# X-Stracker-Api-Key: sk_REPLACEResponse envelope
{
"success": true,
"data": { /* endpoint-specific payload */ }
}Errors
Failed responses always have success: false and an error object with a stable code and a human-readable message:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "company_name is required"
}
}| HTTP status | When | What to do |
|---|---|---|
400 | Validation failed (missing required fields, bad enum, migration not applied for company/contact notes, assignee not in org, slot unavailable). | Read error.message; fix the payload. |
401 | Missing or invalid Authorization / X-Stracker-Api-Key. | Check the API key; confirm the header is present. |
403 | Key is valid but lacks permission (e.g. non-admin calling agent admin endpoints), or org scope mismatch. | Use an org-admin key, or confirm the resource belongs to the key's org. |
404 | Resource not found or not visible to this org. | Verify the id and org scoping. |
500 | Unexpected server error. | Retry with backoff; report if persistent. |
Users
Endpoints at a glance
| Action | Method + Path | Summary |
|---|---|---|
| List users | GET /users | List active org users (id = users.id for assignee; includes org_user_id). |
GET /users
List active org users (id = users.id for assignee; includes org_user_id).
Request example
curl -sS https://api.strackerapp.com/v1/users \
-H "Authorization: Bearer sk_REPLACE"Response 200 OK
{
"success": true,
"data": {
"users": [
{ "id": 9, "org_user_id": 3, "name": "Alex Rep", "email": "[email protected]", "user_type": "human" }
]
}
}