> ## Documentation Index > Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt > Use this file to discover all available pages before exploring further. # PublicApiUpdateGroup > PATCH /api/v1/organizations/{orgId}/groups/{groupId} Use this endpoint through the Developer API or the matching `firstsales` CLI command when available. Responses use the stable FirstSales public error envelope. ## OpenAPI ````yaml PATCH /api/v1/organizations/{orgId}/groups/{groupId} openapi: 3.1.0 info: title: FirstSales Developer API version: 1.0.0 description: >- Public v1 developer API for FirstSales.io. Generated from live step definitions — do not hand-edit. servers: - url: https://sandbox.api.app.firstsales.io - url: https://api.app.firstsales.io security: - bearerAuth: [] tags: - name: Activities - name: Alerts - name: API Keys - name: Authentication - name: Billing - name: Blocked Domains - name: Campaigns - name: Companies - name: Connectors - name: Contacts - name: Copilot - name: Dashboard - name: Deals - name: Direct Email - name: Email Authentication - name: Inbox - name: Knowledge Bases - name: Learning - name: Offerings - name: Organizations - name: Product Updates - name: Sequence Library - name: Signals description: >- Beta. Find people who comment on or react to LinkedIn posts by a keyword, a person or a company page. Each scan costs 10x the scraper cost in credits (1 credit = $0.01), capped by the daily budget of the signal. A scan that adds no new person is free. - name: Suppression - name: Team - name: Tracking Domains - name: Warmup paths: /api/v1/organizations/{orgId}/groups/{groupId}: patch: tags: - Team summary: PublicApiUpdateGroup operationId: patchApiV1OrganizationsOrgIdGroupsGroupId parameters: - name: orgId in: path required: true schema: type: string minLength: 1 - name: groupId in: path required: true schema: type: string minLength: 1 - name: Idempotency-Key in: header required: true schema: type: string minLength: 1 maxLength: 200 requestBody: required: true content: application/json: schema: anyOf: - type: object properties: targetVersion: type: integer minimum: 0 maximum: 9007199254740991 name: type: string minLength: 1 maxLength: 80 permissions: minItems: 1 maxItems: 84 type: array items: type: string enum: - campaign:create - campaign:edit - campaign:delete - campaign:view - campaign:launch - campaign:pause - contact:create - contact:edit - contact:delete - contact:view - contact:import - contact_list:create - contact_list:edit - contact_list:delete - contact_list:view - connector:connect - connector:disconnect - connector:view - inbox:view - inbox:reply - inbox:approve_draft - inbox:reject_draft - kb:create - kb:edit - kb:delete - kb:view - offering:create - offering:edit - offering:delete - offering:view - tracking_domain:create - tracking_domain:delete - tracking_domain:view - domain_auth:view - domain_auth:create - deal:create - deal:edit - deal:delete - deal:view - deal:move_stage - deal:set_status - pipeline:create - pipeline:edit - pipeline:delete - pipeline:view - company:create - company:edit - company:delete - company:view - activity:create - activity:view - scheduled_activity:create - scheduled_activity:edit - scheduled_activity:delete - scheduled_activity:view - suppression:view - blocked_domain:view - blocked_domain:manage - direct_email:send - direct_email:approve - changelog:view - changelog:engage - org:settings - org:billing - org:transfer - org:delete - org:view - member:invite - member:remove - member:suspend - member:view - group:create - group:edit - group:delete - group:assign - domain_allowlist:view - domain_allowlist:manage - workspace:create - workspace:view - workspace:delete - workspace:settings - api_key:view - api_key:create - api_key:revoke required: - targetVersion - name additionalProperties: false - type: object properties: targetVersion: type: integer minimum: 0 maximum: 9007199254740991 name: type: string minLength: 1 maxLength: 80 permissions: minItems: 1 maxItems: 84 type: array items: type: string enum: - campaign:create - campaign:edit - campaign:delete - campaign:view - campaign:launch - campaign:pause - contact:create - contact:edit - contact:delete - contact:view - contact:import - contact_list:create - contact_list:edit - contact_list:delete - contact_list:view - connector:connect - connector:disconnect - connector:view - inbox:view - inbox:reply - inbox:approve_draft - inbox:reject_draft - kb:create - kb:edit - kb:delete - kb:view - offering:create - offering:edit - offering:delete - offering:view - tracking_domain:create - tracking_domain:delete - tracking_domain:view - domain_auth:view - domain_auth:create - deal:create - deal:edit - deal:delete - deal:view - deal:move_stage - deal:set_status - pipeline:create - pipeline:edit - pipeline:delete - pipeline:view - company:create - company:edit - company:delete - company:view - activity:create - activity:view - scheduled_activity:create - scheduled_activity:edit - scheduled_activity:delete - scheduled_activity:view - suppression:view - blocked_domain:view - blocked_domain:manage - direct_email:send - direct_email:approve - changelog:view - changelog:engage - org:settings - org:billing - org:transfer - org:delete - org:view - member:invite - member:remove - member:suspend - member:view - group:create - group:edit - group:delete - group:assign - domain_allowlist:view - domain_allowlist:manage - workspace:create - workspace:view - workspace:delete - workspace:settings - api_key:view - api_key:create - api_key:revoke required: - targetVersion - permissions additionalProperties: false responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/PublicTeamGroupMutationResponse' '400': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '401': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '403': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '404': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '409': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '429': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '500': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' '503': description: Public API error content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' default: description: Error response content: application/json: schema: $ref: '#/components/schemas/PublicErrorEnvelope' security: - developerKeyBearer: [] components: schemas: PublicTeamGroupMutationResponse: type: object properties: group: type: object properties: id: type: string minLength: 1 name: type: string minLength: 1 slug: type: string minLength: 1 permissions: type: array items: type: string enum: - campaign:create - campaign:edit - campaign:delete - campaign:view - campaign:launch - campaign:pause - contact:create - contact:edit - contact:delete - contact:view - contact:import - contact_list:create - contact_list:edit - contact_list:delete - contact_list:view - connector:connect - connector:disconnect - connector:view - inbox:view - inbox:reply - inbox:approve_draft - inbox:reject_draft - kb:create - kb:edit - kb:delete - kb:view - offering:create - offering:edit - offering:delete - offering:view - tracking_domain:create - tracking_domain:delete - tracking_domain:view - domain_auth:view - domain_auth:create - deal:create - deal:edit - deal:delete - deal:view - deal:move_stage - deal:set_status - pipeline:create - pipeline:edit - pipeline:delete - pipeline:view - company:create - company:edit - company:delete - company:view - activity:create - activity:view - scheduled_activity:create - scheduled_activity:edit - scheduled_activity:delete - scheduled_activity:view - suppression:view - blocked_domain:view - blocked_domain:manage - direct_email:send - direct_email:approve - changelog:view - changelog:engage - org:settings - org:billing - org:transfer - org:delete - org:view - member:invite - member:remove - member:suspend - member:view - group:create - group:edit - group:delete - group:assign - domain_allowlist:view - domain_allowlist:manage - workspace:create - workspace:view - workspace:delete - workspace:settings - api_key:view - api_key:create - api_key:revoke isSystem: type: boolean const: false memberCount: type: integer minimum: 0 maximum: 9007199254740991 targetVersion: type: integer minimum: 0 maximum: 9007199254740991 required: - id - name - slug - permissions - isSystem - memberCount - targetVersion additionalProperties: false required: - group additionalProperties: false PublicErrorEnvelope: type: object properties: error: type: object properties: code: type: string message: type: string requestId: type: string details: type: object additionalProperties: true required: - code - message - requestId required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: Legacy compatibility bearer scheme for generated consumers. developerKeyBearer: type: http scheme: bearer description: FirstSales developer API key bearer token (fs-key-*). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.