---
title: "Criar acordo (submete pedido de alteração)"
method: POST
path: "/api/socios/{partner_id}/agreements"
tags: ["Sócios (Protected)"]
---

# Criar acordo (submete pedido de alteração)

`POST /api/socios/{partner_id}/agreements`

## Path parameters

- `partner_id` integer, required

## Headers

- `x-api-token` string, nullable

## Request body

- AgreementCreate — Body for POST /api/socios/{id}/agreements — submits AGREEMENT_CREATE.
  - `idpointofsale` integer, required
  - `percentagem` union, required
    - number
    - string
  - `inicio` string, date, required
  - `fim` string, date, nullable

## Response `200`

Successful Response

- ChangeRequestSubmitResponse — Return shape for any mutation endpoint. If the request applied immediately (bootstrap / requester is sole sócio), `status` is APPLIED and the new entity's id (if any) is in `applied_entity_id`. Otherwise status is PENDING and the caller waits on votes.
  - `change_request_id` integer, required
  - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'EXPIRED' | 'APPLIED', required
  - `approvers_pending` PendingApprover[]
    - `partner_id` integer, required
    - `utilizador_id` integer, nullable
    - `nome` string, nullable
  - `applied_entity_id` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/8492136eefc5/schema)