Roark Project API
The Project API from Roark — 1 operation(s) for project.
The Project API from Roark — 1 operation(s) for project.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/roark:roark-project-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Roark Analytics Project API
description: The Roark Analytics API gives you access to the same API that powers the award winning Roark Analytics platform.
version: 1.0.0
servers:
- description: Production
url: https://api.roark.ai
security:
- Bearer: []
tags:
- name: Project
paths:
/v1/projects:
get:
responses:
'200':
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ProjectListResponse'
required:
- data
description: Projects available to this credential
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Authentication error
example:
type: authentication
code: unauthorized
message: Authentication required
description: Unauthorized
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Rate limit error
example:
type: rate_limit
code: too_many_requests
message: Rate limit exceeded
description: Too Many Requests
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server error
example:
type: internal
code: internal_error
message: Internal server error
description: Internal Server Error
operationId: getV1Projects
tags:
- Project
summary: List projects available to this credential
description: Returns every project the calling credential may act on, with the permissions it holds in each. A project-scoped API key returns the single project it is bound to. A user-scoped credential returns the projects in its organization where the holder is an active member. Use the returned id in the X-Roark-Project-Id header.
components:
schemas:
ProjectListResponse:
type: object
properties:
projects:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
slug:
type: string
organization:
type: object
properties:
id:
type: string
name:
type: string
required:
- id
- name
grantedPermissions:
type: array
items:
type: string
required:
- id
- name
- slug
- organization
- grantedPermissions
required:
- projects
description: Projects this credential may act on
example:
projects:
- id: 1a2b3c4d-5e6f-4701-8293-a4b5c6d7e8f9
name: Support Line
slug: support-line
organization:
id: 9f8e7d6c-5b4a-4312-9081-7f6e5d4c3b2a
name: Example Inc
grantedPermissions:
- call:read
- metric:read
ErrorResponse:
type: object
properties:
type:
type: string
enum:
- validation
- authentication
- forbidden
- not_found
- conflict
- payment_required
- rate_limit
- internal
description: The error type category
examples:
- validation
- authentication
code:
type: string
description: Machine-readable error code identifier
examples:
- invalid_parameter
- missing_required_field
- unauthorized
message:
type: string
description: Human-readable error message
examples:
- The request was invalid
- Authentication required
param:
type: string
description: The parameter that caused the error (if applicable)
examples:
- email
- user_id
details:
description: Additional error context information
required:
- type
- code
- message
securitySchemes:
Bearer:
type: http
scheme: bearer
bearerFormat: JWT