{"api_version":"1.0.0","platform":"Flow","description":"Shift scheduling, credentialing, and workforce management API","auth_methods":["session","api_key"],"api_key_format":"Authorization: Bearer flow_<prefix>_<secret>","endpoints":{"orgs":{"path":"/api/v1/orgs/","methods":["GET"],"auth":true,"description":"List and retrieve organizations"},"members":{"path":"/api/v1/members/","methods":["GET"],"auth":true,"description":"List organization members with roles"},"schedules":{"path":"/api/v1/schedules/","methods":["GET","POST","PUT","DELETE"],"auth":true,"description":"Manage schedules","actions":{"coverage":{"path":"/api/v1/schedules/{id}/coverage/","methods":["GET"],"description":"Get assignment coverage summary for a date range","params":["date_from","date_to"]}}},"workslots":{"path":"/api/v1/workslots/","methods":["GET","POST","PUT","DELETE"],"auth":true,"description":"Manage shift slots within schedules","actions":{"eligible_users":{"path":"/api/v1/workslots/{id}/eligible-users/","methods":["GET"],"description":"Get users eligible for a shift on a specific date","params":["date"]}}},"availability":{"path":"/api/v1/availability/","methods":["GET","POST","PUT","DELETE"],"auth":true,"description":"Manage user availability for shifts"},"assignments":{"path":"/api/v1/assignments/","methods":["GET","POST","DELETE"],"auth":true,"description":"Manage shift assignments","actions":{"bulk_create":{"path":"/api/v1/assignments/bulk-create/","methods":["POST"],"description":"Create multiple assignments in one request"}}},"swap_requests":{"path":"/api/v1/swap-requests/","methods":["GET","POST"],"auth":true,"description":"Create and manage shift swap requests"},"credential_templates":{"path":"/api/v1/credentials/templates/","methods":["GET","POST","PUT","DELETE"],"auth":true,"description":"Manage credential type definitions"},"credential_requirements":{"path":"/api/v1/credentials/requirements/","methods":["GET","POST","PUT"],"auth":true,"description":"Manage user credentials with approval workflow"},"integrations":{"path":"/api/v1/integrations/credentialing/","methods":["GET","POST","PUT","DELETE"],"auth":true,"description":"Configure credentialing platform integrations"},"api_keys":{"path":"/api/v1/api-keys/","methods":["GET","POST","DELETE"],"auth":true,"description":"Manage API keys (admin only)"},"audit_log":{"path":"/api/v1/audit-log/","methods":["GET"],"auth":true,"description":"Read-only audit trail (admin only)"}},"docs_url":"/api/v1/docs/","schema_url":"/api/v1/schema/","guide_url":"/api/v1/guide/","agent_workflow":{"description":"Recommended workflow for AI agents managing shifts","steps":["1. GET /api/v1/schedules/ — find active schedules","2. GET /api/v1/schedules/{id}/coverage/?date_from=&date_to= — identify gaps","3. GET /api/v1/workslots/{id}/eligible-users/?date= — find eligible users for unfilled slots","4. POST /api/v1/assignments/bulk-create/ — fill multiple slots at once","5. GET /api/v1/audit-log/ — verify actions were logged"]}}