{"openapi":"3.1.0","info":{"title":"IdeaLine API","version":"1.0.0","description":"Read access to your workspace: ideas on Studio and Enterprise plans, everything else on Enterprise. JSON over HTTPS. Authenticate with an API key (Settings, API keys). Errors use RFC 9457 problem details. Lists use keyset (cursor) pagination, `filter[...]` and `sort`.","termsOfService":"https://idealine.io/legal/terms.html"},"servers":[{"url":"https://idealine.io/v1"}],"security":[{"apiKey":[]}],"paths":{"/":{"get":{"summary":"API index","security":[],"responses":{"200":{"description":"Links to the resources"}}}},"/workspace":{"get":{"summary":"The workspace this key belongs to","responses":{"200":{"description":"Workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/projects":{"get":{"summary":"List projects","parameters":[{"name":"page[size]","in":"query","description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"page[cursor]","in":"query","description":"Opaque cursor from `links.next` of the previous page.","schema":{"type":"string","maxLength":300}},{"name":"filter[status]","in":"query","description":"Comma-separated status ids.","schema":{"type":"string"}},{"name":"filter[category]","in":"query","description":"Comma-separated project types, such as Content or Email.","schema":{"type":"string"}},{"name":"filter[assignee]","in":"query","schema":{"type":"string"}},{"name":"filter[due_before]","in":"query","description":"YYYY-MM-DD, inclusive.","schema":{"type":"string","format":"date"}},{"name":"filter[due_after]","in":"query","description":"YYYY-MM-DD, inclusive.","schema":{"type":"string","format":"date"}},{"name":"filter[updated_since]","in":"query","description":"ISO 8601 timestamp; only items updated after it.","schema":{"type":"string","format":"date-time"}},{"name":"sort","in":"query","description":"`-updated_at` (default, newest first) or `updated_at`.","schema":{"type":"string","enum":["-updated_at","updated_at"],"default":"-updated_at"}}],"responses":{"200":{"description":"A page of projects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectList"}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/projects/{id}":{"get":{"summary":"Get one project","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/ideas":{"get":{"summary":"List ideas (Studio and Enterprise)","description":"Ideas from the IdeaLine idea board. Comments, people and AI activity are never included.","parameters":[{"name":"page[size]","in":"query","description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"page[cursor]","in":"query","description":"Opaque cursor from `links.next` of the previous page.","schema":{"type":"string","maxLength":300}},{"name":"filter[stage]","in":"query","description":"Comma-separated: raw, exploring, ready, parked.","schema":{"type":"string"}},{"name":"filter[launched]","in":"query","description":"true for ideas promoted to a project, false for the rest.","schema":{"type":"string","enum":["true","false"]}},{"name":"filter[due_before]","in":"query","schema":{"type":"string","format":"date"}},{"name":"filter[due_after]","in":"query","schema":{"type":"string","format":"date"}},{"name":"filter[updated_since]","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["-updated_at","updated_at"],"default":"-updated_at"}}],"responses":{"200":{"description":"A page of ideas","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Idea"}},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/ideas/{id}":{"get":{"summary":"Get one idea (Studio and Enterprise)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Idea","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Idea"}}}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/members":{"get":{"summary":"List people in the workspace","parameters":[{"name":"page[size]","in":"query","description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"page[cursor]","in":"query","description":"Opaque cursor from `links.next` of the previous page.","schema":{"type":"string","maxLength":300}},{"name":"filter[role]","in":"query","description":"Comma-separated: owner, admin, member, viewer.","schema":{"type":"string"}},{"name":"filter[email]","in":"query","description":"Exact email address (case-insensitive).","schema":{"type":"string","format":"email"}}],"responses":{"200":{"description":"A page of members","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberList"}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/members/{id}":{"get":{"summary":"Get one person","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberResponse"}}}},"400":{"description":"Invalid parameter","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid API key","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Studio or Enterprise plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An IdeaLine API key (idl_live_...)."}},"schemas":{"Problem":{"type":"object","required":["type","title","status"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"code":{"type":"string"},"request_id":{"type":"string"}}},"Links":{"type":"object","properties":{"self":{"type":"string"},"next":{"type":["string","null"]}}},"PageMeta":{"type":"object","properties":{"page":{"type":"object","properties":{"size":{"type":"integer"},"has_more":{"type":"boolean"}}}}},"Workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"workspace"},"name":{"type":"string"},"plan":{"type":"string"}}},"WorkspaceResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Workspace"}}},"Project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"project"},"title":{"type":"string"},"status":{"type":"string"},"category":{"type":"string"},"start":{"type":["string","null"],"format":"date"},"due":{"type":["string","null"],"format":"date"},"assignee":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"ProjectResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Project"}}},"ProjectList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/PageMeta"}}},"Idea":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"idea"},"title":{"type":"string"},"notes":{"type":"string"},"audience":{"type":"string"},"goal":{"type":"string"},"stage":{"type":"string","enum":["raw","exploring","ready","parked"]},"tags":{"type":"array","items":{"type":"string"}},"due":{"type":["string","null"],"format":"date"},"revisit":{"type":["string","null"],"format":"date"},"launched":{"type":"boolean"},"project_id":{"type":["string","null"],"format":"uuid"},"steps":{"type":"object","properties":{"total":{"type":"integer"},"done":{"type":"integer"}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"Member":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"member"},"email":{"type":"string"},"display_name":{"type":["string","null"]},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"permission_level":{"type":"string","enum":["full","standard","view"]},"created_at":{"type":"string","format":"date-time"}}},"MemberResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Member"}}},"MemberList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Member"}},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}}}}