> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Invia un messaggio alla sessione
> Invia un messaggio a una sessione attiva. La sessione verrà ripresa automaticamente se è in pausa.
Il `devin_id` è l'ID di sessione preceduto da `devin-` (ad esempio, `devin-abc123`).
## Autorizzazioni
Richiede un utente di servizio con l'autorizzazione `ManageOrgSessions` a livello di organizzazione.
## OpenAPI
````yaml it/v3-openapi.yaml POST /v3/organizations/{org_id}/sessions/{devin_id}/messages
openapi: 3.1.0
info:
description: API Devin v3 con autenticazione utente di servizio e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/sessions/{devin_id}/messages:
post:
tags:
- sessions
summary: Invia un messaggio alla sessione
description: >-
Invia un messaggio a una sessione attiva. La sessione verrà ripresa
automaticamente se è in pausa.
operationId: >-
handle_post_message_v3_organizations__org_id__sessions__devin_id__messages_post
parameters:
- description: 'ID dell''organizzazione (prefisso: org-)'
in: path
name: org_id
required: true
schema:
anyOf:
- type: string
- type: 'null'
example: org-abc123def456
title: Org Id
- description: 'ID della sessione Devin (prefisso: devin-)'
in: path
name: devin_id
required: true
schema:
anyOf:
- type: string
- type: 'null'
example: devin-abc123def456
title: Devin Id
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SessionMessageCreateRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SessionResponse'
description: Risposta con esito positivo
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Errore di validazione
components:
schemas:
SessionMessageCreateRequest:
properties:
attachment_urls:
anyOf:
- items:
format: uri
maxLength: 2083
minLength: 1
type: string
type: array
- type: 'null'
title: Attachment Urls
message:
title: Message
type: string
message_as_user_id:
anyOf:
- type: string
- type: 'null'
title: Message As User Id
required:
- message
title: SessionMessageCreateRequest
type: object
SessionResponse:
properties:
acus_consumed:
title: Acus Consumed
type: number
category:
anyOf:
- enum:
- bug_fixing
- ci_cd_and_devops
- code_quality_and_security
- code_review
- code_review_and_analysis
- data_and_automation
- documentation_and_content
- feature_development
- migrations_and_upgrades
- other
- refactoring_and_optimization
- research_and_exploration
- security
- unit_test_generation
type: string
- type: 'null'
description: >-
La categoria del caso d'uso assegnata alla sessione, se la
categorizzazione è stata eseguita. Valorizzato solo negli endpoint
get/list.
title: Category
child_session_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Child Session Ids
created_at:
title: Created At
type: integer
is_archived:
default: false
title: Is Archived
type: boolean
org_id:
title: Org Id
type: string
origin:
anyOf:
- enum:
- webapp
- slack
- teams
- api
- linear
- jira
- automation
- cli
- desktop
- code_scan
- other
type: string
- type: 'null'
description: L'origine da cui è stata creata la sessione.
title: Origin
parent_session_id:
anyOf:
- type: string
- type: 'null'
title: Parent Session Id
playbook_id:
anyOf:
- type: string
- type: 'null'
title: Playbook Id
pull_requests:
items:
$ref: '#/components/schemas/SessionPullRequest'
title: Pull Requests
type: array
service_user_id:
anyOf:
- type: string
- type: 'null'
title: Service User Id
session_id:
title: Session Id
type: string
status:
enum:
- new
- claimed
- running
- exit
- error
- suspended
- resuming
title: Status
type: string
status_detail:
anyOf:
- enum:
- working
- waiting_for_user
- waiting_for_approval
- finished
- inactivity
- user_request
- usage_limit_exceeded
- out_of_credits
- out_of_quota
- no_quota_allocation
- payment_declined
- org_usage_limit_exceeded
- total_session_limit_exceeded
- error
type: string
- type: 'null'
description: >-
Ulteriore dettaglio sullo stato corrente della sessione. Quando
status è 'running': 'working' (sta lavorando attivamente),
'waiting_for_user' (richiede input dell'utente),
'waiting_for_approval' (in attesa dell'approvazione di un'azione in
modalità sicura) oppure 'finished' (attività completata). Quando
status è 'suspended': il motivo della sospensione, ad esempio
'inactivity', 'user_request', 'usage_limit_exceeded',
'out_of_credits', 'out_of_quota', 'no_quota_allocation',
'payment_declined', 'org_usage_limit_exceeded',
'total_session_limit_exceeded' oppure 'error'. Valorizzato solo
negli endpoint get/list.
title: Status Detail
structured_output:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
description: >-
Output strutturato convalidato dalla sessione. Impostato solo sugli
endpoint GET/list.
title: Structured Output
subcategory:
anyOf:
- type: string
- type: 'null'
description: >-
Il nome visualizzato della sottocategoria assegnata alla sessione.
'Other' quando è impostata una categoria ma non è stata assegnata né
risolta alcuna sottocategoria. Valorizzato solo negli endpoint
get/list.
title: Subcategory
tags:
items:
type: string
title: Tags
type: array
title:
anyOf:
- type: string
- type: 'null'
title: Title
updated_at:
title: Updated At
type: integer
url:
title: Url
type: string
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
required:
- session_id
- url
- status
- tags
- org_id
- created_at
- updated_at
- acus_consumed
- pull_requests
title: SessionResponse
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
SessionPullRequest:
properties:
pr_state:
anyOf:
- type: string
- type: 'null'
title: Pr State
pr_url:
title: Pr Url
type: string
required:
- pr_url
- pr_state
title: SessionPullRequest
type: object
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````