> ## Documentation Index > Fetch the complete documentation index at: https://docs.weve.cx/llms.txt > Use this file to discover all available pages before exploring further. # Enviar entrega > Envia ou reenvia a entrega do aluno num bloco da aula. ## OpenAPI ````yaml PUT /v1/clubs/{clubId}/classroom/lessons/{publicId}/assignments/{blockId}/submission openapi: 3.0.3 info: title: weve API description: > Contrato entre a API Go e o dashboard. **Este arquivo é a fonte de verdade**: os tipos e a interface de servidor em Go, e o client TypeScript, são todos gerados daqui (`make openapi`). Handler que divergir da interface não compila. A superfície interna (`/internal/*`) fica de fora de propósito: é acesso de máquina, protegido por segredo dedicado, e não é contrato de cliente. version: 0.2.0 servers: - url: https://api.weve.cx description: produção - url: http://localhost:8080 description: desenvolvimento security: [] tags: - name: health - name: session - name: account - name: clubs - name: members - name: webhooks - name: outgoing-webhooks - name: sales-platforms - name: catalog - name: content - name: classroom - name: community - name: mentorships - name: agents - name: lives - name: students - name: auth - name: campaigns - name: workflows - name: email - name: exports - name: certificates paths: /v1/clubs/{clubId}/classroom/lessons/{publicId}/assignments/{blockId}/submission: parameters: - $ref: '#/components/parameters/OrgId' - $ref: '#/components/parameters/PublicId' - $ref: '#/components/parameters/BlockId' put: tags: - classroom summary: Envia a entrega description: | Uma entrega por aluno e bloco: enviar de novo TROCA o texto e a lista de arquivos, e volta a entrega para a fila de correção — inclusive a que pediu ajuste. A aprovada não muda mais: 409 `already_approved`. Os arquivos são os enviados por `/classroom/assignment-files`, pela própria pessoa e já confirmados; o bloco diz se aceita texto, arquivo e quantos (422 `invalid_submission`). Entregar depois do prazo é permitido, e fica marcado (`late`). Quando a entrega cumpre o último bloco que travava a aula, a aula é concluída na mesma escrita (`lesson_completed`). operationId: submitAssignment requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssignmentSubmissionWrite' responses: '200': description: A entrega gravada content: application/json: schema: $ref: '#/components/schemas/StudentSubmissionResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' security: - studentSession: [] components: parameters: OrgId: name: clubId in: path required: true description: > Id público da organização — o mesmo que `GET /v1/me` devolve em `organization_id`. Na URL o recurso se chama **club**; no contrato e no domínio, organization. A divergência é deliberada: `clubs` é a palavra do produto, e a URL é o que as pessoas leem. É o identificador do provedor de autenticação, e é assim de propósito: o cliente precisa nomear a organização ao pedir o token, e o token é o que prova o escopo. Um id só nosso obrigaria a traduzir um no outro antes de ter um token — e a tradução exigiria uma chamada escopada, que é justamente a que ainda não dá para fazer. O uuid interno da organização não aparece no contrato: ele é o que as chaves estrangeiras do domínio referenciam, e continua sendo nosso. schema: type: string format: uuid PublicId: name: publicId in: path required: true description: A chave curta da URL do classroom. schema: type: string minLength: 1 maxLength: 32 BlockId: name: blockId in: path required: true description: O id do bloco da aula. schema: type: string format: uuid schemas: AssignmentSubmissionWrite: type: object properties: text: description: O texto da entrega, quando o bloco aceita texto. type: string maxLength: 20000 media_ids: description: | Os arquivos, na ordem, quando o bloco aceita arquivo. Troca a lista inteira; vazio tira todos. type: array maxItems: 10 uniqueItems: true items: type: string format: uuid StudentSubmissionResponse: type: object required: - data - lesson_completed properties: data: $ref: '#/components/schemas/StudentSubmission' lesson_completed: description: | Esta entrega cumpriu o último bloco que travava a aula, e a aula foi concluída junto. type: boolean StudentSubmission: type: object required: - id - status - files - submitted_at - late properties: id: type: string format: uuid status: $ref: '#/components/schemas/SubmissionStatus' text: type: string files: description: Os arquivos enviados, na ordem, assinados. type: array items: $ref: '#/components/schemas/SubmissionFile' submitted_at: type: string format: date-time late: description: Enviada depois do prazo que valia no envio. type: boolean feedback: description: O comentário da última correção. type: string reviewed_at: type: string format: date-time ErrorEnvelope: type: object description: >- Envelope único de erro da API. O `code` é o contrato com o cliente — a `message` é diagnóstico, e pode mudar. required: - error properties: error: type: object required: - code properties: code: type: string message: type: string SubmissionStatus: description: | `submitted` espera correção; `approved` foi aprovada e não muda mais; `changes_requested` voltou para o aluno refazer. type: string enum: - submitted - approved - changes_requested x-enum-varnames: - SubmissionSubmitted - SubmissionApproved - SubmissionChangesRequested SubmissionFile: type: object required: - media_id - file_name - url - expires_at properties: media_id: type: string format: uuid file_name: type: string mime: type: string size_bytes: type: integer format: int64 url: description: O download, assinado e com prazo curto. type: string expires_at: type: string format: date-time responses: BadRequest: description: Requisição malformada content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Unauthorized: description: Sessão ausente, expirada ou revogada content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Forbidden: description: > A sessão é válida, mas não age nesta organização. É a mesma resposta para uma organização que não existe — distinguir as duas deixaria enumerar organizações alheias. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' NotFound: description: Recurso não encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Conflict: description: >- Conflito com o estado atual. O `code` diz qual; a descrição da operação lista os possíveis. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' UnprocessableEntity: description: Campos obrigatórios ausentes ou inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' TooManyRequests: description: Teto por IP atingido headers: Retry-After: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' InternalError: description: >- Falha inesperada. O corpo nunca traz o erro real — ele fica no log e no rastreamento. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: studentSession: type: http scheme: bearer description: | Token OPACO de sessão de aluno, emitido por `/v1/auth/sign-in` e verificado contra a nossa tabela — não é JWT e não se lê nada dele. A ida ao banco não é custo novo: toda requisição autenticada já resolve o dono da sessão. Em troca, encerrar uma sessão vale no mesmo instante, sem lista de bloqueio nem janela de tolerância. O classroom o guarda em cookie **host-only**: um cookie de domínio o mandaria para os subdomínios dos outros clubs. ```` ## Related topics - [Enviar teste](/api-reference/webhook-endpoints/test.md) - [Enviar imagem de comentário](/api-reference/comments/image-create.md) - [Enviar imagem da pergunta](/api-reference/agents/classroom-image-create.md) - [Enviar arquivo da mentoria](/api-reference/mentorships/file-create.md)