nominal-api 0.1239.0

use conjure_http::endpoint;
/// The attachment service provides functionality for creating, updating, and archiving attachments uploaded to S3.
#[conjure_http::conjure_endpoints(
    name = "AttachmentService",
    use_legacy_error_serialization
)]
pub trait AttachmentService<#[response_writer] O> {
    ///The body type returned by the `get_content` method.
    type GetContentBody: conjure_http::server::WriteBody<O> + 'static;
    /// Create a new attachment. Assumes the file is already uploaded to S3 through the upload service.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments",
        name = "create",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn create(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::CreateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get an attachment by its RID.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}",
        name = "get",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn get(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get a set of attachments by their RIDs.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments/batch",
        name = "getBatch",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn get_batch(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer, safe)]
        request: super::super::super::super::objects::attachments::api::GetAttachmentsRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::GetAttachmentsResponse,
        conjure_http::private::Error,
    >;
    /// Get the binary content of an attachment.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/content",
        name = "getContent",
        produces = conjure_http::server::conjure::BinaryResponseSerializer
    )]
    fn get_content(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<Self::GetContentBody, conjure_http::private::Error>;
    /// Get a pre-signed URI to download an attachment. The link expires in 1 minute.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/uri",
        name = "getUri",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn get_uri(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::AttachmentUri,
        conjure_http::private::Error,
    >;
    /// Update an attachment. Only the fields that are set in the request will be updated.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}",
        name = "update",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn update(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::UpdateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Archive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/archive",
        name = "archive"
    )]
    fn archive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
    /// Unarchive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/unarchive",
        name = "unarchive"
    )]
    fn unarchive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
}
/// The attachment service provides functionality for creating, updating, and archiving attachments uploaded to S3.
#[conjure_http::conjure_endpoints(
    name = "AttachmentService",
    use_legacy_error_serialization
)]
pub trait AsyncAttachmentService<#[response_writer] O> {
    ///The body type returned by the `get_content` method.
    type GetContentBody: conjure_http::server::AsyncWriteBody<O> + 'static + Send;
    /// Create a new attachment. Assumes the file is already uploaded to S3 through the upload service.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments",
        name = "create",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn create(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::CreateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get an attachment by its RID.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}",
        name = "get",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get a set of attachments by their RIDs.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments/batch",
        name = "getBatch",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_batch(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer, safe)]
        request: super::super::super::super::objects::attachments::api::GetAttachmentsRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::GetAttachmentsResponse,
        conjure_http::private::Error,
    >;
    /// Get the binary content of an attachment.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/content",
        name = "getContent",
        produces = conjure_http::server::conjure::BinaryResponseSerializer
    )]
    async fn get_content(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<Self::GetContentBody, conjure_http::private::Error>;
    /// Get a pre-signed URI to download an attachment. The link expires in 1 minute.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/uri",
        name = "getUri",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_uri(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::AttachmentUri,
        conjure_http::private::Error,
    >;
    /// Update an attachment. Only the fields that are set in the request will be updated.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}",
        name = "update",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn update(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::UpdateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Archive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/archive",
        name = "archive"
    )]
    async fn archive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
    /// Unarchive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/unarchive",
        name = "unarchive"
    )]
    async fn unarchive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
}
/// The attachment service provides functionality for creating, updating, and archiving attachments uploaded to S3.
#[conjure_http::conjure_endpoints(
    name = "AttachmentService",
    use_legacy_error_serialization,
    local
)]
pub trait LocalAsyncAttachmentService<#[response_writer] O> {
    ///The body type returned by the `get_content` method.
    type GetContentBody: conjure_http::server::LocalAsyncWriteBody<O> + 'static;
    /// Create a new attachment. Assumes the file is already uploaded to S3 through the upload service.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments",
        name = "create",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn create(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::CreateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get an attachment by its RID.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}",
        name = "get",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Get a set of attachments by their RIDs.
    #[endpoint(
        method = POST,
        path = "/attachments/v1/attachments/batch",
        name = "getBatch",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_batch(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer, safe)]
        request: super::super::super::super::objects::attachments::api::GetAttachmentsRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::GetAttachmentsResponse,
        conjure_http::private::Error,
    >;
    /// Get the binary content of an attachment.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/content",
        name = "getContent",
        produces = conjure_http::server::conjure::BinaryResponseSerializer
    )]
    async fn get_content(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<Self::GetContentBody, conjure_http::private::Error>;
    /// Get a pre-signed URI to download an attachment. The link expires in 1 minute.
    #[endpoint(
        method = GET,
        path = "/attachments/v1/attachments/{rid}/uri",
        name = "getUri",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_uri(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<
        super::super::super::super::objects::attachments::api::AttachmentUri,
        conjure_http::private::Error,
    >;
    /// Update an attachment. Only the fields that are set in the request will be updated.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}",
        name = "update",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn update(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::objects::attachments::api::UpdateAttachmentRequest,
    ) -> Result<
        super::super::super::super::objects::attachments::api::Attachment,
        conjure_http::private::Error,
    >;
    /// Archive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/archive",
        name = "archive"
    )]
    async fn archive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
    /// Unarchive an attachment.
    #[endpoint(
        method = PUT,
        path = "/attachments/v1/attachments/{rid}/unarchive",
        name = "unarchive"
    )]
    async fn unarchive(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[path(
            name = "rid",
            decoder = conjure_http::server::conjure::FromPlainDecoder,
            safe
        )]
        rid: super::super::super::super::objects::api::rids::AttachmentRid,
    ) -> Result<(), conjure_http::private::Error>;
}