rumoro-dev API keys API
The API keys API from rumoro-dev — 2 operation(s) for api keys.
The API keys API from rumoro-dev — 2 operation(s) for api keys.
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/rumoro-dev:rumoro-dev-api-keys-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: Rumoro API keys API
version: 0.0.1
description: Social listening for developers and AI agents.
servers:
- url: https://api.rumoro.dev
tags:
- name: API Keys
paths:
/v1/api-keys:
post:
operationId: createApiKey
summary: Create an API key
description: Issues a new API key in this workspace. The key is shown only in this response, and only its hash is stored. `expiresAt` makes it stop working at a set time, useful for a contractor or a one-off script. An expired key stays in the list until you revoke it.
tags:
- API Keys
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 80
description: A name for the key. Defaults to "default".
scope:
type: string
enum:
- read
- write
default: write
description: write can do everything. read is limited to GET.
expiresAt:
type: string
description: Expiry time in ISO 8601 or epoch ms, later than now. Set it for keys you hand to a script or contractor. Omit it or send null and the key never expires.
format: date-time
responses:
'201':
description: The created key, visible only now
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: The key's id (key_...).
name:
type: string
prefix:
type: string
description: The start of the key, so you can tell keys apart.
scope:
type: string
enum:
- read
- write
description: write can do everything. read is limited to GET.
createdAt:
type: string
description: UTC time in ISO 8601.
lastUsedAt:
type:
- string
- 'null'
description: UTC time in ISO 8601.
expiresAt:
type:
- string
- 'null'
description: When the key expires. Null for a key without expiry. Expired keys stay in the list until revoked.
key:
type: string
description: The complete key. It is only shown here, so save it now.
required:
- id
- name
- prefix
- scope
- createdAt
- lastUsedAt
- expiresAt
- key
'400':
description: expiresAt must be a future time
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: The API key is missing or not valid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
get:
operationId: listApiKeys
summary: List API keys
description: Lists the workspace's active keys, latest first, with name, prefix, scope, expiry and last use. Revoked keys and secrets are never listed.
tags:
- API Keys
security:
- bearerAuth: []
responses:
'200':
description: All keys, latest first, without the secret
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
description: The key's id (key_...).
name:
type: string
prefix:
type: string
description: The start of the key, so you can tell keys apart.
scope:
type: string
enum:
- read
- write
description: write can do everything. read is limited to GET.
createdAt:
type: string
description: UTC time in ISO 8601.
lastUsedAt:
type:
- string
- 'null'
description: UTC time in ISO 8601.
expiresAt:
type:
- string
- 'null'
description: When the key expires. Null for a key without expiry. Expired keys stay in the list until revoked.
required:
- id
- name
- prefix
- scope
- createdAt
- lastUsedAt
- expiresAt
required:
- data
'401':
description: The API key is missing or not valid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/v1/api-keys/{id}:
delete:
operationId: revokeApiKey
summary: Revoke an API key
description: Revokes the key. The API refuses it right away, and cached checks catch up within a few minutes.
tags:
- API Keys
security:
- bearerAuth: []
parameters:
- schema:
type: string
minLength: 1
description: The API key's id (key_...).
example: key_abc123
required: true
description: The API key's id (key_...).
name: id
in: path
responses:
'204':
description: The key no longer works
'401':
description: The API key is missing or not valid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: No API key with this id
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- unauthorized
- forbidden
- read_only_key
- validation_error
- not_found
- invalid_cursor
- payload_too_large
- rate_limited
- duplicate_keyword
- insufficient_balance
- keyword_limit_reached
- billing_not_configured
- unknown_channel
- not_a_digest
- hourly_email_unsupported
- slack_not_connected
- slack_not_configured
- telegram_not_configured
- email_not_configured
- invalid_assignee
- classification_pending
- already_member
- last_owner
- duplicate_segment
- duplicate_view
- duplicate_group
- default_group
- default_group_context
- invalid_signature
- invalid_token
- upstream_unavailable
- internal_error
- unsupported_media_type
- request_timeout
- key_limit
- conflict
- no_billing_owner
- rule_disabled
- no_channels
- channel_disabled
- no_recipients
- recipient_suppressed
- confirmation_rate_limited
- confirmation_requires_resend
- email_test_rate_limited
- email_hourly_limit
- email_idempotency_expired
- email_transport_unavailable
- delivery_not_configured
- delivery_key_unavailable
- not_retryable
- not_replayable
- digest_has_replay
- digest_retry_expired
- delivery_request_incomplete
- request_conflict
- stale_version
- version_conflict
- already_classified
- keyword_inactive
- source_unavailable
- source_timeout
- invalid_host
- invalid_origin
- database_unavailable
- database_not_ready
- not_configured
description: A stable code for programs. Branch on it, not on the message. New codes may be added, so treat an unknown one as a general failure with the same status.
message:
type: string
description: A description for people. Its wording can change.
requestId:
type: string
description: This request's id, also sent in the X-Request-Id header. Include it when you contact support.
retryAfterSeconds:
type: integer
description: Seconds to wait before retrying, on rate_limited and other errors you can retry. Same value as the Retry-After header.
required:
- code
- message
description: Details of the error.
required:
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: An API key from POST /v1/api-keys. Keys start with ref_.
x-rumoro-errors:
- code: unauthorized
status: 401
source: user
retryable: false
description: The credential is missing or does not belong to a workspace.
fix: 'Send Authorization: Bearer ref_… with a key from /api-keys.'
- code: forbidden
status: 403
source: user
retryable: false
description: The credential works but is not allowed to do this.
- code: read_only_key
status: 403
source: user
retryable: false
description: A read-only key called an endpoint that writes.
fix: Create a key with write scope.
- code: validation_error
status: 400
source: user
retryable: false
description: The body or query is not valid. The message says which field.
- code: not_found
status: 404
source: user
retryable: false
description: Your workspace has nothing with this id. An id from another workspace also returns 404, never 403.
- code: invalid_cursor
status: 400
source: user
retryable: false
description: The cursor could not be read, or was issued for another sort. Start again from the first page.
- code: payload_too_large
status: 413
source: user
retryable: false
description: 'The body exceeds the endpoint limit (128 KiB for JSON). A 409 with this code: a delivery whose payload was too large cannot be retried or replayed.'
- code: rate_limited
status: 429
source: user
retryable: true
description: The workspace sent over 600 requests in a minute across all its keys and tokens, or reached an endpoint's own limit. Retry-After and error.retryAfterSeconds tell you when to try again.
fix: Wait Retry-After seconds and send the same request again. X-RateLimit-Remaining on every response says how much room is left.
- code: duplicate_keyword
status: 409
source: user
retryable: false
description: This group already has the term. Each group can hold a term once, and other groups can hold it too.
- code: insufficient_balance
status: 402
source: user
retryable: false
description: The balance cannot pay for one more keyword-day.
fix: Top up from Billing; tracking resumes on its own.
- code: keyword_limit_reached
status: 402
source: user
retryable: false
description: The workspace already runs 500 keywords, or has 500 that are not deleted.
- code: billing_not_configured
status: 503
source: system
retryable: false
description: No payment provider is set up on this deployment.
- code: unknown_channel
status: 400
source: user
retryable: false
description: An alert named a channel id that is not in this workspace.
- code: not_a_digest
status: 400
source: user
retryable: false
description: An action for digests was used on an instant alert.
- code: hourly_email_unsupported
status: 400
source: user
retryable: false
description: An hourly alert got an email channel, which could mean 24 emails a day. Use Slack, Telegram or a webhook, or send a daily digest by email.
- code: slack_not_connected
status: 409
source: user
retryable: false
description: Slack must be connected in Settings first. Returned as 404 by the Slack connection endpoints and 409 elsewhere.
- code: slack_not_configured
status: 503
source: system
retryable: false
description: No Slack app is set up on this deployment.
- code: telegram_not_configured
status: 503
source: system
retryable: false
description: No Telegram bot is set up on this deployment.
- code: email_not_configured
status: 503
source: system
retryable: false
description: This deployment has no email sender set up, so email destinations cannot be used.
- code: invalid_assignee
status: 400
source: user
retryable: false
description: The assignee is not in the workspace.
- code: classification_pending
status: 409
source: user
retryable: true
description: Relevance or sentiment feedback was sent before the classifier scored the mention.
- code: already_member
status: 409
source: user
retryable: false
description: The invited address already belongs to a member.
- code: last_owner
status: 409
source: user
retryable: false
description: The workspace would have no owner left after this removal.
- code: duplicate_segment
status: 409
source: user
retryable: false
description: Another segment in the workspace has this name.
- code: duplicate_view
status: 409
source: user
retryable: false
description: Another view in the workspace has this name.
- code: duplicate_group
status: 409
source: user
retryable: false
description: Another group in the workspace has this name or externalId.
- code: default_group
status: 409
source: user
retryable: false
description: The default group cannot be deleted. It holds keywords created without a group.
- code: default_group_context
status: 400
source: user
retryable: false
description: The default group uses the workspace's company profile, which you change with PATCH /v1/company. Only other groups can have their own description.
- code: invalid_signature
status: 401
source: user
retryable: false
description: An incoming webhook had no valid signature.
- code: invalid_token
status: 400
source: user
retryable: false
description: A signed link (unsubscribe, confirmation, preferences) was tampered with or is malformed.
- code: upstream_unavailable
status: 502
source: platform
retryable: true
description: An outside service such as Slack or Polar failed during the request. Retry with increasing waits.
- code: internal_error
status: 500
source: system
retryable: false
description: Something failed on our side; 502 when Telegram failed a bot lookup. The response carries a requestId; quote it to support.
- code: unsupported_media_type
status: 415
source: user
retryable: false
description: 'A body was sent without Content-Type: application/json.'
- code: request_timeout
status: 408
source: user
retryable: true
description: The body did not arrive within 5 seconds.
- code: key_limit
status: 409
source: user
retryable: false
description: The workspace already has 100 active keys. Revoke one first.
- code: conflict
status: 409
source: user
retryable: false
description: A resource with these values already exists.
- code: no_billing_owner
status: 404
source: user
retryable: false
description: There is no owner to bill in this workspace yet.
- code: rule_disabled
status: 409
source: user
retryable: false
description: The rule is turned off. Enable it before a test or a run.
- code: no_channels
status: 409
source: user
retryable: false
description: The rule has no destination to test.
- code: channel_disabled
status: 409
source: user
retryable: false
description: A destination is turned off. Enable it first.
- code: no_recipients
status: 409
source: user
retryable: false
description: An email destination needs a recipient before it can be turned on.
- code: recipient_suppressed
status: 409
source: user
retryable: false
description: The address bounced or complained, so no more email goes to it.
- code: confirmation_rate_limited
status: 429
source: user
retryable: true
description: 'Too many confirmation emails: wait a minute; at most three per address a day and twenty per workspace an hour.'
- code: confirmation_requires_resend
status: 409
source: user
retryable: false
description: A confirmation email is sent again with a resend, not a delivery retry.
- code: email_test_rate_limited
status: 429
source: user
retryable: true
description: More than five email tests on this destination this hour.
- code: email_hourly_limit
status: 409
source: user
retryable: false
description: The destination's hourly email limit is reached; the mention waits for the next daily digest.
- code: email_idempotency_expired
status: 409
source: user
retryable: false
description: The email's safe retry window passed. Check its receipts before an explicit replay, which may send it twice.
- code: email_transport_unavailable
status: 503
source: system
retryable: false
description: Email sending is not set up for this delivery on this deployment.
- code: delivery_not_configured
status: 503
source: system
retryable: false
description: Destinations that need a stored secret are not set up on this deployment.
- code: delivery_key_unavailable
status: 503
source: system
retryable: false
description: A destination's stored secret cannot be read on this deployment.
- code: not_retryable
status: 409
source: user
retryable: false
description: Only failed or blocked deliveries can be retried.
- code: not_replayable
status: 409
source: user
retryable: false
description: A delivery can be replayed once it has finished.
- code: digest_has_replay
status: 409
source: user
retryable: false
description: This digest delivery has a newer replay. Recover that one.
- code: digest_retry_expired
status: 409
source: user
retryable: false
description: The digest's six-hour retry window passed. Replay it instead.
- code: delivery_request_incomplete
status: 500
source: system
retryable: true
description: The saved outcome of a test could not be read. Read it again; don't send a new test.
- code: request_conflict
status: 409
source: user
retryable: false
description: This requestId was already used for another request. Retry the original, or use a new id.
- code: stale_version
status: 409
source: user
retryable: false
description: The resource changed since you read it. Read it again before saving.
- code: version_conflict
status: 409
source: user
retryable: true
description: The webhook's managed rules changed at the same time. Read it again and retry.
- code: already_classified
status: 409
source: user
retryable: false
description: The mention is already scored; there is nothing to retry.
- code: keyword_inactive
status: 409
source: user
retryable: false
description: The mention's keyword is paused. Resume it before retrying the score.
- code: source_unavailable
status: 502
source: platform
retryable: true
description: 'Live search: the platform didn''t answer (503 when it is rate limiting us).'
- code: source_timeout
status: 504
source: platform
retryable: true
description: 'Live search: the platform didn''t answer in time.'
- code: invalid_host
status: 403
source: user
retryable: false
description: 'MCP: the request''s Host is not this server''s.'
- code: invalid_origin
status: 403
source: user
retryable: false
description: 'MCP: the request''s Origin is not allowed.'
- code: database_unavailable
status: 503
source: system
retryable: true
description: A temporary database problem. Retry with backoff.
- code: database_not_ready
status: 503
source: system
retryable: false
description: The deployment's database needs maintenance; retrying won't help until it is done.
- code: not_configured
status: 503
source: system
retryable: false
description: This deployment has no database configured.