Core — team

naftiko: 1.0.0-alpha2
info:
  label: Core — team
  description: 'Core — team. 41 operations. Lead operation: List all teams the current user belongs to. Self-contained Naftiko capability covering one business surface.'
  tags:
  - Scalar
  - team
  created: '2026-05-20'
  modified: '2026-05-20'
binds:
- namespace: env
  keys:
    SCALAR_API_KEY: SCALAR_API_KEY
capability:
  consumes:
  - type: http
    namespace: core-team
    baseUri: https://example.com
    description: Core — team business capability. Self-contained, no shared references.
    resources:
    - name: me-teams
      path: /me/teams
      operations:
      - name: getmeteams
        method: GET
        description: List all teams the current user belongs to
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: team-slug
      path: /team/slug
      operations:
      - name: postteamslug
        method: POST
        description: Update a team slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-slug-available
      path: /team/slug/available
      operations:
      - name: postteamslugavailable
        method: POST
        description: Check if team slug is available
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-create
      path: /team/create
      operations:
      - name: postteamcreate
        method: POST
        description: Create a new team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-invite
      path: /team/invite
      operations:
      - name: postteaminvite
        method: POST
        description: Invite a new member to the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteteaminvite
        method: DELETE
        description: Cancel a team invite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: patchteaminvite
        method: PATCH
        description: Resend an existing team invite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-accept-invite
      path: /team/accept-invite
      operations:
      - name: getteamacceptinvite
        method: GET
        description: Accept an email team invite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: query
          type: string
          description: query parameter token.
          required: true
    - name: team-rename
      path: /team/rename
      operations:
      - name: postteamrename
        method: POST
        description: Rename a team and handle multiple record updates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-image
      path: /team/image
      operations:
      - name: postteamimage
        method: POST
        description: Update a team logo image and handle multiple record updates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-leave
      path: /team/leave
      operations:
      - name: getteamleave
        method: GET
        description: Allow a user to leave a team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: team
      path: /team
      operations:
      - name: deleteteam
        method: DELETE
        description: Delete a team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: team-delete-member
      path: /team/delete-member
      operations:
      - name: postteamdeletemember
        method: POST
        description: Remove a user from the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-update
      path: /team/update
      operations:
      - name: postteamupdate
        method: POST
        description: Update a team record
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-update-user
      path: /team/update-user
      operations:
      - name: postteamupdateuser
        method: POST
        description: Update a team user record (safe properties only)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-billing
      path: /team/billing
      operations:
      - name: getteambilling
        method: GET
        description: Team billing invoice and plan summary
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: team-billing-email
      path: /team/billing/email
      operations:
      - name: postteambillingemail
        method: POST
        description: Update a team's billing email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-update-plan
      path: /team/update/plan
      operations:
      - name: postteamupdateplan
        method: POST
        description: Update a team's billing plan
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-update-role
      path: /team/update-role
      operations:
      - name: postteamupdaterole
        method: POST
        description: Updates user role for a team member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: internal-team-archive
      path: /internal/team/archive
      operations:
      - name: deleteinternalteamarchive
        method: DELETE
        description: Scheduled internal deletion for premium teams
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-namespace-update
      path: /team/namespace/update
      operations:
      - name: postteamnamespaceupdate
        method: POST
        description: Update a team namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-namespace
      path: /team/namespace
      operations:
      - name: postteamnamespace
        method: POST
        description: Create a team namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-namespace-available
      path: /team/namespace/available
      operations:
      - name: postteamnamespaceavailable
        method: POST
        description: Check if team namespace is available
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-namespaces
      path: /team/namespaces
      operations:
      - name: getteamnamespaces
        method: GET
        description: Get all namespaces for the current team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: team-onboarding-setup
      path: /team/onboarding/setup
      operations:
      - name: postteamonboardingsetup
        method: POST
        description: Onboarding team setup
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-onboarding-complete
      path: /team/onboarding/complete
      operations:
      - name: postteamonboardingcomplete
        method: POST
        description: Onboarding team complete
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: internal-team-features
      path: /internal/team/features
      operations:
      - name: postinternalteamfeatures
        method: POST
        description: Internal endpoint to update feature flags for a team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: pubsub-invite-team-member
      path: /pubsub/invite-team-member
      operations:
      - name: postpubsubinviteteammember
        method: POST
        description: Pubsub invite a new member to the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: pubsub-team-member-invited
      path: /pubsub/team-member-invited
      operations:
      - name: postpubsubteammemberinvited
        method: POST
        description: Pubsub team member invited
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-icon
      path: /team/icon
      operations:
      - name: postteamicon
        method: POST
        description: Adds a custom icon to the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteteamicon
        method: DELETE
        description: Deletes a custom icon from the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-authentication-domain
      path: /team/authentication/domain
      operations:
      - name: postteamauthenticationdomain
        method: POST
        description: Add a domain to authentication allowlist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteteamauthenticationdomain
        method: DELETE
        description: Remove a domain from authentication allowlist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-authentication-method
      path: /team/authentication/method
      operations:
      - name: postteamauthenticationmethod
        method: POST
        description: Enable or disable authentication method for the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-authentication-user
      path: /team/authentication/user
      operations:
      - name: postteamauthenticationuser
        method: POST
        description: Edit team authentication user controls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteteamauthenticationuser
        method: DELETE
        description: Remove team authentication user controls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-authentication-user-method
      path: /team/authentication/user/method
      operations:
      - name: postteamauthenticationusermethod
        method: POST
        description: Enable or disable authentication method for a user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: team-external-access-method
      path: /team/external-access/method
      operations:
      - name: postteamexternalaccessmethod
        method: POST
        description: Enable or disable external access methods for the team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: internal-teams-teamuid-notify-mcp-approval-required
      path: /internal/teams/{teamUid}/notify-mcp-approval-required
      operations:
      - name: postinternalteamsteamuidnotifymcpapprovalrequired
        method: POST
        description: Notify a team's admins/owners that an MCP server version is awaiting approval.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamUid
          in: path
          type: string
          description: path parameter teamUid.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-update
      path: /user/update
      operations:
      - name: postuserupdate
        method: POST
        description: Update user record
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: internal-user-ban
      path: /internal/user/ban
      operations:
      - name: postinternaluserban
        method: POST
        description: Ban a user by email. Banning will deny a user from creating an account or logging in.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: core-team-rest
    port: 8080
    description: REST adapter for Core — team. One resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/me/teams
      name: me-teams
      description: REST surface for me-teams.
      operations:
      - method: GET
        name: getmeteams
        description: List all teams the current user belongs to
        call: core-team.getmeteams
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/slug
      name: team-slug
      description: REST surface for team-slug.
      operations:
      - method: POST
        name: postteamslug
        description: Update a team slug
        call: core-team.postteamslug
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/slug/available
      name: team-slug-available
      description: REST surface for team-slug-available.
      operations:
      - method: POST
        name: postteamslugavailable
        description: Check if team slug is available
        call: core-team.postteamslugavailable
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/create
      name: team-create
      description: REST surface for team-create.
      operations:
      - method: POST
        name: postteamcreate
        description: Create a new team
        call: core-team.postteamcreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/invite
      name: team-invite
      description: REST surface for team-invite.
      operations:
      - method: POST
        name: postteaminvite
        description: Invite a new member to the team
        call: core-team.postteaminvite
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteteaminvite
        description: Cancel a team invite
        call: core-team.deleteteaminvite
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchteaminvite
        description: Resend an existing team invite
        call: core-team.patchteaminvite
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/accept-invite
      name: team-accept-invite
      description: REST surface for team-accept-invite.
      operations:
      - method: GET
        name: getteamacceptinvite
        description: Accept an email team invite
        call: core-team.getteamacceptinvite
        with:
          token: rest.token
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/rename
      name: team-rename
      description: REST surface for team-rename.
      operations:
      - method: POST
        name: postteamrename
        description: Rename a team and handle multiple record updates
        call: core-team.postteamrename
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/image
      name: team-image
      description: REST surface for team-image.
      operations:
      - method: POST
        name: postteamimage
        description: Update a team logo image and handle multiple record updates
        call: core-team.postteamimage
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/leave
      name: team-leave
      description: REST surface for team-leave.
      operations:
      - method: GET
        name: getteamleave
        description: Allow a user to leave a team
        call: core-team.getteamleave
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team
      name: team
      description: REST surface for team.
      operations:
      - method: DELETE
        name: deleteteam
        description: Delete a team
        call: core-team.deleteteam
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/delete-member
      name: team-delete-member
      description: REST surface for team-delete-member.
      operations:
      - method: POST
        name: postteamdeletemember
        description: Remove a user from the team
        call: core-team.postteamdeletemember
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/update
      name: team-update
      description: REST surface for team-update.
      operations:
      - method: POST
        name: postteamupdate
        description: Update a team record
        call: core-team.postteamupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/update-user
      name: team-update-user
      description: REST surface for team-update-user.
      operations:
      - method: POST
        name: postteamupdateuser
        description: Update a team user record (safe properties only)
        call: core-team.postteamupdateuser
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/billing
      name: team-billing
      description: REST surface for team-billing.
      operations:
      - method: GET
        name: getteambilling
        description: Team billing invoice and plan summary
        call: core-team.getteambilling
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/billing/email
      name: team-billing-email
      description: REST surface for team-billing-email.
      operations:
      - method: POST
        name: postteambillingemail
        description: Update a team's billing email
        call: core-team.postteambillingemail
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/update/plan
      name: team-update-plan
      description: REST surface for team-update-plan.
      operations:
      - method: POST
        name: postteamupdateplan
        description: Update a team's billing plan
        call: core-team.postteamupdateplan
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/update-role
      name: team-update-role
      description: REST surface for team-update-role.
      operations:
      - method: POST
        name: postteamupdaterole
        description: Updates user role for a team member
        call: core-team.postteamupdaterole
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/team/archive
      name: internal-team-archive
      description: REST surface for internal-team-archive.
      operations:
      - method: DELETE
        name: deleteinternalteamarchive
        description: Scheduled internal deletion for premium teams
        call: core-team.deleteinternalteamarchive
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/namespace/update
      name: team-namespace-update
      description: REST surface for team-namespace-update.
      operations:
      - method: POST
        name: postteamnamespaceupdate
        description: Update a team namespace
        call: core-team.postteamnamespaceupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/namespace
      name: team-namespace
      description: REST surface for team-namespace.
      operations:
      - method: POST
        name: postteamnamespace
        description: Create a team namespace
        call: core-team.postteamnamespace
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/namespace/available
      name: team-namespace-available
      description: REST surface for team-namespace-available.
      operations:
      - method: POST
        name: postteamnamespaceavailable
        description: Check if team namespace is available
        call: core-team.postteamnamespaceavailable
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/namespaces
      name: team-namespaces
      description: REST surface for team-namespaces.
      operations:
      - method: GET
        name: getteamnamespaces
        description: Get all namespaces for the current team
        call: core-team.getteamnamespaces
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/onboarding/setup
      name: team-onboarding-setup
      description: REST surface for team-onboarding-setup.
      operations:
      - method: POST
        name: postteamonboardingsetup
        description: Onboarding team setup
        call: core-team.postteamonboardingsetup
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/onboarding/complete
      name: team-onboarding-complete
      description: REST surface for team-onboarding-complete.
      operations:
      - method: POST
        name: postteamonboardingcomplete
        description: Onboarding team complete
        call: core-team.postteamonboardingcomplete
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/team/features
      name: internal-team-features
      description: REST surface for internal-team-features.
      operations:
      - method: POST
        name: postinternalteamfeatures
        description: Internal endpoint to update feature flags for a team
        call: core-team.postinternalteamfeatures
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pubsub/invite-team-member
      name: pubsub-invite-team-member
      description: REST surface for pubsub-invite-team-member.
      operations:
      - method: POST
        name: postpubsubinviteteammember
        description: Pubsub invite a new member to the team
        call: core-team.postpubsubinviteteammember
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pubsub/team-member-invited
      name: pubsub-team-member-invited
      description: REST surface for pubsub-team-member-invited.
      operations:
      - method: POST
        name: postpubsubteammemberinvited
        description: Pubsub team member invited
        call: core-team.postpubsubteammemberinvited
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/icon
      name: team-icon
      description: REST surface for team-icon.
      operations:
      - method: POST
        name: postteamicon
        description: Adds a custom icon to the team
        call: core-team.postteamicon
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteteamicon
        description: Deletes a custom icon from the team
        call: core-team.deleteteamicon
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/authentication/domain
      name: team-authentication-domain
      description: REST surface for team-authentication-domain.
      operations:
      - method: POST
        name: postteamauthenticationdomain
        description: Add a domain to authentication allowlist
        call: core-team.postteamauthenticationdomain
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteteamauthenticationdomain
        description: Remove a domain from authentication allowlist
        call: core-team.deleteteamauthenticationdomain
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/authentication/method
      name: team-authentication-method
      description: REST surface for team-authentication-method.
      operations:
      - method: POST
        name: postteamauthenticationmethod
        description: Enable or disable authentication method for the team
        call: core-team.postteamauthenticationmethod
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/team/authentication/user
      name: team-authentication-user
      description: REST surface for team-authentication-user.
      operations:
      - method: POST
        name: postteamauthenticationuser
        description: Edit team authentication user controls
        call: core-team.postteamauthenticationuser
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteteamauthenticationuse

# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/scalar/refs/heads/main/capabilities/core-team.yaml