canonical: https://jentic.com/apis/5day.io/5day-io

# 5day.io API

Jentic publishes the only available OpenAPI specification for 5day.io API, keeping it validated and agent-ready. The 5day.io API exposes the integration service that drives 5day.io's project and work management platform, covering integrations, workflows, webhooks, and event subscriptions across seventeen endpoints. Teams use it to register external integrations, run automated workflows, push and receive events, and link 5day projects to outside systems. Authentication is bearer token using credentials issued from a workspace's integration settings.

## For AI agents

Register integrations, trigger and execute workflows, manage webhooks, and push events into 5day.io project workspaces. Useful for agents wiring 5day projects into external automations.

## Scope

Does not handle 5day.io billing, user account creation, or core task UI rendering - use for integration, workflow, webhook, and event operations only.

## Capabilities

- Register and update third-party integrations connected to a 5day.io workspace
- Trigger workflow executions with structured input payloads
- List historical workflow runs and inspect their status
- Subscribe to events through webhooks with filterable trigger types
- Publish custom events that fan out to subscribed workflows
- Rotate or revoke webhook signing secrets without manual portal access

## Use cases

### Connect 5day.io Projects to External Systems

Operations teams use the integrations endpoints to register connections between 5day.io and CRMs, helpdesks, or finance tools so that activity in those systems creates or updates 5day projects automatically. The /integrations and /integrations/{id} endpoints expose CRUD-style operations that replace per-tenant configuration scripts. A typical connection takes one to two days of development versus building and hosting a custom middleware service.

Example prompt: Call POST /integrations to register a Salesforce integration with the workspace's API token, then verify the connection is active by calling GET /integrations/{id}.

### Trigger Project Workflows on External Events

Companies that automate onboarding, project kickoff, or recurring reviews publish events into 5day.io and let workflows fan out the resulting tasks. The /workflows/{id}/execute endpoint accepts a structured payload and runs the configured workflow, while /events allows agents to publish arbitrary domain events without hardcoding workflow IDs. Setup is roughly a day for a basic workflow and three to four days for a multi-stage automation.

Example prompt: Call POST /events with type 'customer_signed' and customer details, then poll GET /workflows/{id} to confirm the onboarding workflow ran to completion.

### Webhook Subscriptions for Real-Time Project Events

Engineering teams that need a live feed of project changes register webhooks against the 5day.io workspace. The /webhooks endpoints let an agent enumerate, create, and rotate subscriptions with filterable event types, replacing manual portal configuration. A webhook subscription with handler code is typically a half-day to ship.

Example prompt: Call POST /webhooks with a callback URL and event filter for 'project.status_changed', then verify by triggering a status change and confirming the callback receives the event.

### Agent-Managed 5day.io Operations via Jentic

AI agents connected through Jentic can keep 5day.io workspaces in sync with other tools by calling the integrations, workflows, and webhooks endpoints in a single conversation. Jentic returns the operation schema and stores the bearer token in the vault, so the agent does not see credentials and does not need a hand-rolled SDK. End-to-end time from intent to result is under a minute.

Example prompt: Search Jentic for 'trigger a 5day workflow', load the /workflows/{id}/execute schema, and execute the onboarding workflow with the new customer payload.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /integrations | List registered integrations |
| POST | /integrations | Register a new integration |
| GET | /workflows | List workflows in the workspace |
| POST | /workflows/{id}/execute | Execute a workflow with an input payload |
| POST | /webhooks | Create a webhook subscription |
| POST | /events | Publish a custom event into the workflow engine |

## Key resources

- **Integrations** — Third-party connections registered against a 5day.io workspace
- **Workflows** — Definable automations that run on triggers and produce project tasks
- **Webhooks** — HTTP callbacks fired on workspace events
- **Events** — Custom domain events published into the workflow engine

## Why Jentic

- **Setup:** Wiring the 5day.io API by hand means managing its bearer token, targeting the gateway.5day.io v1 base, and shaping integration, workflow, and webhook payloads yourself. Through Jentic you install once, import the 5day.io API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** 5day.io puts the workflow id in the URL path (/workflows/{id}/execute), so a rule can pin your agent to executing one workflow. You choose the operations it may call, so creating integrations or webhooks is not included unless you add them.
- **Credential handling:** Your 5day.io bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'trigger a 5day workflow' or 'subscribe to 5day events', and Jentic returns the matching 5day.io operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Asana API** — General-purpose project management API with broader ecosystem and SDKs
- **ClickUp API** — Task and project management API with extensive automation features
- **monday.com API** — Visual work management platform API for boards, items, and automations
- **n8n API** — Open-source workflow automation that can call 5day.io events and webhooks

## FAQ

### Why is there no official OpenAPI spec for 5day.io API?

5day.io publishes Swagger UI for its integration service but does not distribute a downloadable OpenAPI document for direct ingestion. Jentic generates and maintains this spec so AI agents and developers can call 5day.io through structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the 5day.io API use?

The API uses HTTP bearer authentication. A workspace administrator generates a token in 5day.io's integration settings and the token is sent in the Authorization header. When called through Jentic the token is held in the encrypted vault and attached at execution time so it never enters the agent's context.

### Can I trigger a 5day.io workflow programmatically?

Yes. Call POST /workflows/{id}/execute with the workflow ID and an input payload that matches the workflow's expected schema. The response includes a run ID you can poll via GET /workflows/{id} to inspect status.

### What are the rate limits for the 5day.io API?

5day.io does not publish a numeric rate limit on its developer documentation. Plan for fair-use limits based on your workspace tier and back off on HTTP 429 responses. For high-volume event publishing, batch requests where the API supports it and avoid tight polling loops on /workflows.

### How do I subscribe to 5day.io project events through Jentic?

After running pip install jentic and setting JENTIC_AGENT_API_KEY, search Jentic for 'subscribe to 5day events', load the POST /webhooks schema, and execute it with your callback URL and event filter. Jentic returns the webhook ID and signing secret in the response.

### Is the 5day.io API available on the free plan?

API access is gated by 5day.io's paid plans. Check the workspace settings panel under Integrations to confirm whether the integration service is enabled for your subscription tier before issuing tokens.

### Can I limit what my agent is allowed to do with the 5day.io API?

Yes. Because you run Jentic One yourself, your own rules decide which 5day.io operations and credentials the agent may use. Since 5day.io carries the workflow id in the URL path (/workflows/{id}/execute), a rule can pin the agent to executing a single workflow. You pick the operations it can call, so creating integrations via POST /integrations or subscribing webhooks via POST /webhooks stays off limits unless you explicitly grant them.