Connected accounts

Override a limit

Set caps for one action on this account. Fields you leave out keep the channel default. A cap can be tightened or loosened, never removed. Raising a cap above the default is allowed but answered with a warning: it increases the risk of the channel restricting the account.

PATCH

/api/v1/connected-accounts/{connectedAccountId}/limits/{action}

Path parameters

connectedAccountId

required

string · uuid

Connected account id

action

required

"linkedin_invitation" | "linkedin_cancel_invitation" | "linkedin_message" | "linkedin_inmail" | "linkedin_profile_view" | "linkedin_search" | "linkedin_comment" | "linkedin_reaction" | "instagram_message" | "instagram_profile_view" | "instagram_follow" | "instagram_unfollow" | "instagram_comment" | "instagram_reaction" | "instagram_post"

Metered action, e.g. linkedin_profile_view.

Request bodyrequired

houroptional

integer

Hourly cap.

dayoptional

integer

Daily cap.

weekoptional

integer

Weekly cap.

Response

200The limit after the change.

limit

object

One metered action on the connected account.

action

"linkedin_invitation" | "linkedin_cancel_invitation" | "linkedin_message" | "linkedin_inmail" | "linkedin_profile_view" | "linkedin_search" | "linkedin_comment" | "linkedin_reaction" | "instagram_message" | "instagram_profile_view" | "instagram_follow" | "instagram_unfollow" | "instagram_comment" | "instagram_reaction" | "instagram_post"

defaultLimits

object

Channel defaults for this action.

hour

integer | null

Hourly cap. Null when this action has no hourly cap.

day

integer

Daily cap.

week

integer | null

Weekly cap. Null when this action has no weekly cap.

override

object | null

Caps set for this account, or null when it runs on the defaults.

hour

integer | null

Hourly cap. Null when this action has no hourly cap.

day

integer

Daily cap.

week

integer | null

Weekly cap. Null when this action has no weekly cap.

limits

object

Caps currently enforced: the defaults with this account’s override applied.

hour

integer | null

Hourly cap. Null when this action has no hourly cap.

day

integer

Daily cap.

week

integer | null

Weekly cap. Null when this action has no weekly cap.

usage

object

How much of this action the connected account has already used.

hour

integer

Calls made in the current UTC hour.

day

integer

Calls made in the current UTC day.

week

integer

Calls made in the last seven days.

warning

string | null

Set when a cap now sits above the channel default; the change is applied regardless.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy