> ## Documentation Index > Fetch the complete documentation index at: https://docs.getsales.io/llms.txt > Use this file to discover all available pages before exploring further. # Set sender profile smart limits > Switch gtm's smart limits on or off for the sender profile's LinkedIn account, every bucket at once (gtm keeps one switch per account; the per-row field mirrors it, read-only). Answers the limits after the write (read_sender_profile_limits' shape). Use it instead of update_sender_profile_linkedin_limit for the switch; a real flip puts every row back on gtm's platform defaults first. Refusals in error.context.reason: 403 gtm_scope_missing, 429 gtm_busy, 503 gtm_unavailable, 409 gtm_refused. Contract: - MCP tool `set_sender_profile_linkedin_smart_limits`, registry package `mcp.unibox/sender_profiles`, mount `unibox.sender-profiles`. - Operation `action`, response envelope `action`. - Flags: none. ## OpenAPI ````yaml /api-reference/unibox/openapi.yaml post /api/sender-profiles/{sid}/limits/linkedin/smart-limits openapi: 3.0.3 info: title: 'GetSales public contract: gs.service.unibox' description: >- The team inbox and the AI SDR: every LinkedIn and email thread in one place (conversations, messages, the timeline events), the manual tasks a thread spawns, the sender profiles the team speaks through with their LinkedIn account and mailboxes, and the one agent per team with its scenarios, plans and runs. GENERATED. This document is projected from the Zod MCP tool registry in `product/mcp/gs.mcp` (one tool per public endpoint, 1:1). Do not edit it by hand; edit the tool definition and regenerate with `pnpm openapi:public`. Surface: the public `/api` contract of `gs.service.unibox`, 125 operations. This is the only OpenAPI document the platform publishes. Internal (`/internal`) and health endpoints are deliberately absent: they are not part of any contract, they can change without notice, and the service source is their only description. Conventions: - Auth is a bearer JWT, optionally narrowed by the `Team-SID` header. - Every success body is an MCP envelope: `success: true` plus one typed `operation` shape (`search`, `get`, `create`, `update`, `delete`, `metrics`, `group_by`, `action`), and a `meta` block with `trace_id` for support. - Every failure is the same `McpError` envelope with a code from a fixed 16-code taxonomy, so a client maps errors once. - Lists page with `page_size` (0 to 500, default 50) plus an opaque forward `cursor`; `page_size: 0` returns counts only. - On `GET` and `DELETE`, object-valued query parameters (`filter`, `sort`) travel as JSON text and array-valued ones repeat as `name[]=value`. - The MCP-only `_meta` field (usage analytics) never reaches the backend and is not part of this contract. version: '1.0' contact: name: GetSales url: https://getsales.io email: support@getsales.io license: name: Proprietary url: https://getsales.io/terms servers: - url: https://beta.getsales.io/unibox/v1 description: >- Production (the gateway path on the beta ring; the origin is provisioned per DEPLOY_MAP.md) security: - BearerJwt: [] TeamSid: [] tags: - name: agent_answers description: >- Registry package `mcp.unibox/agent_answers`, served on MCP mount `unibox.knowledge`. - name: agent_conversation_uploads description: >- Registry package `mcp.unibox/agent_conversation_uploads`, served on MCP mount `unibox.agent-memory`. - name: agent_examples description: >- Registry package `mcp.unibox/agent_examples`, served on MCP mount `unibox.agent-memory`. - name: agent_hints description: >- Registry package `mcp.unibox/agent_hints`, served on MCP mount `unibox.agent-memory`. - name: agent_plans description: >- Registry package `mcp.unibox/agent_plans`, served on MCP mount `unibox.agent`. - name: agent_runs description: >- Registry package `mcp.unibox/agent_runs`, served on MCP mount `unibox.agent-memory`. - name: agent_scenarios description: >- Registry package `mcp.unibox/agent_scenarios`, served on MCP mount `unibox.agent`. - name: agent_source_parses description: >- Registry package `mcp.unibox/agent_source_parses`, served on MCP mount `unibox.knowledge`. - name: agent_sources description: >- Registry package `mcp.unibox/agent_sources`, served on MCP mount `unibox.knowledge`. - name: agent_tests description: >- Registry package `mcp.unibox/agent_tests`, served on MCP mount `unibox.agent-memory`. - name: agents description: >- Registry package `mcp.unibox/agents`, served on MCP mount `unibox.website`. - name: conversation_events description: >- Registry package `mcp.unibox/conversation_events`, served on MCP mount `unibox.inbox`. - name: conversations description: >- Registry package `mcp.unibox/conversations`, served on MCP mount `unibox.inbox`. - name: messages description: >- Registry package `mcp.unibox/messages`, served on MCP mount `unibox.inbox`. - name: sender_profiles description: >- Registry package `mcp.unibox/sender_profiles`, served on MCP mount `unibox.sender-profiles`. - name: tasks description: Registry package `mcp.unibox/tasks`, served on MCP mount `unibox.inbox`. - name: timeline description: >- Registry package `mcp.unibox/timeline`, served on MCP mount `unibox.inbox`. paths: /api/sender-profiles/{sid}/limits/linkedin/smart-limits: post: tags: - sender_profiles summary: Set sender profile smart limits description: >- Switch gtm's smart limits on or off for the sender profile's LinkedIn account, every bucket at once (gtm keeps one switch per account; the per-row field mirrors it, read-only). Answers the limits after the write (read_sender_profile_limits' shape). Use it instead of update_sender_profile_linkedin_limit for the switch; a real flip puts every row back on gtm's platform defaults first. Refusals in error.context.reason: 403 gtm_scope_missing, 429 gtm_busy, 503 gtm_unavailable, 409 gtm_refused. Contract: - MCP tool `set_sender_profile_linkedin_smart_limits`, registry package `mcp.unibox/sender_profiles`, mount `unibox.sender-profiles`. - Operation `action`, response envelope `action`. - Flags: none. operationId: set_sender_profile_linkedin_smart_limits parameters: - name: sid in: path required: true description: Sender profile sid (ub_sp_…). schema: type: string minLength: 18 maxLength: 18 pattern: ^ub_sp_ description: Sender profile sid (ub_sp_…). requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SetSenderProfileLinkedinSmartLimitsRequest' responses: '200': description: '`action` success envelope.' content: application/json: schema: $ref: >- #/components/schemas/SetSenderProfileLinkedinSmartLimitsResponse 4XX: $ref: '#/components/responses/McpClientError' 5XX: $ref: '#/components/responses/McpServerError' components: schemas: SetSenderProfileLinkedinSmartLimitsRequest: type: object description: Request body of `set_sender_profile_linkedin_smart_limits`. properties: enabled: type: boolean description: >- true lets gtm warm the account up and lower the effective caps on its own signals; false leaves every bucket at the number it has. A real flip puts the rows back on gtm's platform defaults first. required: - enabled SetSenderProfileLinkedinSmartLimitsResponse: type: object properties: success: type: boolean enum: - true operation: type: string enum: - action action: type: string description: kebab-case verb; matches the route segment. item: type: object nullable: true additionalProperties: {} result: type: object properties: linkedin: type: array items: type: object properties: sid: type: string description: >- The smart-limit row (ln_sm_…): pass it to update_sender_profile_linkedin_limit. limit_type: type: string description: >- The action the row budgets: send_connection_requests, send_messages, send_inmails, visit_profiles, react_posts, comment_posts, endorse_skills, and the two umbrella buckets networking_general and messaging_general. daily_limit: type: integer nullable: true target_limit: type: integer nullable: true smart_limit: type: integer nullable: true description: >- The cap gtm is actually applying today when smart limits are on. learned_ceiling: type: integer nullable: true description: What the learner has worked the account up to. delay_in_seconds: type: integer nullable: true batch_size: type: integer nullable: true done_today_count: type: integer nullable: true done_7d_count: type: integer nullable: true smart_limits_enabled: type: boolean nullable: true description: >- The account's switch, mirrored on every row (gtm keeps one per account). learning_enabled: type: boolean nullable: true status: type: string nullable: true description: gtm's own row status, e.g. active or held. hold_till: type: string nullable: true description: >- ISO 8601 UTC: nothing of this type goes out before then. reset_hold lifts it. linkedin_quota_hit_till: type: string nullable: true description: 'ISO 8601 UTC: LinkedIn''s own quota refuses until then.' last_reset_at: type: string nullable: true required: - sid - limit_type - daily_limit - target_limit - smart_limit - learned_ceiling - delay_in_seconds - batch_size - done_today_count - done_7d_count - smart_limits_enabled - learning_enabled - status - hold_till - linkedin_quota_hit_till - last_reset_at description: >- One row per outreach action type, read live from gtm. Empty on a sender profile with no LinkedIn account. smart_limits_enabled: type: boolean nullable: true description: >- gtm's account-wide smart-limits switch (one per account); every row's smart_limits_enabled mirrors it. Flip it with set_sender_profile_linkedin_smart_limits. null on a sender profile with no LinkedIn account, or one gtm's roster does not list. mailboxes: type: array items: type: object properties: email_account_sid: type: string address: type: string nullable: true status: type: string nullable: true is_primary: type: boolean nullable: true sending_limits: type: object nullable: true additionalProperties: {} warmup_config: type: object nullable: true additionalProperties: {} required: - email_account_sid - address - status - is_primary - sending_limits - warmup_config description: >- Each mailbox's limits off the sender profile mirror (gtm keeps no per-mailbox counters to show). required: - linkedin - smart_limits_enabled - mailboxes meta: type: object properties: trace_id: type: string description: UUID v7; same 128-bit value as the X-Trace-Id header. span_id: type: string pattern: ^[0-9a-f]{16}$ description: 16 hex chars, root span of this request. timestamp: type: string description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time. duration_ms: type: integer minimum: 0 description: Server-side wall clock. team_sid: type: string nullable: true description: >- The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends. actor_type: type: string nullable: true description: >- user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends. required: - trace_id - span_id - timestamp - duration_ms required: - success - operation - action - item - result - meta McpError: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string enum: - validation_failed - nothing_to_update - not_found - relation_not_found - invalid_transition - limit_exceeded - payment_required - duplicate_rejected - conflict - delete_blocked - unauthorized - forbidden - rate_limited - internal_error - service_unavailable - not_implemented message: type: string recoverable: type: boolean suggestion: type: string field_errors: type: object additionalProperties: type: array items: type: object properties: rule: type: string message: type: string required: - rule - message blockers: type: array items: type: object properties: type: type: string description: >- Machine-readable blocker type (active_flow, pending_tasks, …). severity: type: string enum: - hard - soft description: >- hard = external action required; soft = acknowledge is enough. description: type: string entity_sid: type: string nullable: true count: type: integer resolution: type: string description: 'Hard: tool name to call. Soft: code for acknowledge[].' resolution_hint: type: string required: - type - severity - description - entity_sid - resolution - resolution_hint context: type: object additionalProperties: {} required: - code - message - recoverable meta: type: object properties: trace_id: type: string description: UUID v7; same 128-bit value as the X-Trace-Id header. span_id: type: string pattern: ^[0-9a-f]{16}$ description: 16 hex chars, root span of this request. timestamp: type: string description: ISO 8601 UTC (Y-m-dTH:i:sZ), response time. duration_ms: type: integer minimum: 0 description: Server-side wall clock. team_sid: type: string nullable: true description: >- The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends. actor_type: type: string nullable: true description: >- user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends. required: - trace_id - span_id - timestamp - duration_ms required: - success - error responses: McpClientError: description: >- MCP error envelope. `error.code` is one of validation_failed, nothing_to_update, not_found, relation_not_found, invalid_transition, limit_exceeded, payment_required, duplicate_rejected, conflict, delete_blocked, unauthorized, forbidden, rate_limited, not_implemented. content: application/json: schema: $ref: '#/components/schemas/McpError' McpServerError: description: >- MCP error envelope with `error.code` internal_error or service_unavailable. content: application/json: schema: $ref: '#/components/schemas/McpError' securitySchemes: BearerJwt: type: http scheme: bearer bearerFormat: JWT description: >- Access token issued by gs.service.id. Its `access_identity` claim carries `team_sid`, `actor_sid` and `actor_type`, and that team scope is authoritative. TeamSid: type: apiKey in: header name: Team-SID description: >- Team scope for tokens that do not carry one. Ignored when the token already names a team. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.