Skip to main content

\CollectionsApi

All URIs are relative to https://api.estuary.tech

MethodHTTP requestDescription
CollectionsColuuidCommitPostPost /collections/{coluuid}/commitProduce a CID of the collection contents
CollectionsColuuidContentsDeleteDelete /collections/{coluuid}/contentsDeletes a content from a collection
CollectionsColuuidDeleteDelete /collections/{coluuid}Deletes a collection
CollectionsColuuidGetGet /collections/{coluuid}Get contents in a collection
CollectionsColuuidPostPost /collections/{coluuid}Add contents to a collection
CollectionsFsAddPostPost /collections/fs/addAdd a file to a collection
CollectionsGetGet /collections/List all collections
CollectionsPostPost /collections/Create a new collection

CollectionsColuuidCommitPost

string CollectionsColuuidCommitPost(ctx, coluuid) Produce a CID of the collection contents

This endpoint is used to save the contents in a collection, producing a top-level CID that references all the current CIDs in the collection.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringcoluuid

Return type

string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsColuuidContentsDelete

string CollectionsColuuidContentsDelete(ctx, coluuid, contentid, body) Deletes a content from a collection

This endpoint is used to delete an existing content from an existing collection. If two or more files with the same contentid exist in the collection, delete the one in the specified path

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringCollection ID
contentidstringContent ID
bodyMainDeleteContentFromCollectionBodyVariable to use when filtering for files (must be either 'path' or 'content_id')

Return type

string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsColuuidDelete

CollectionsColuuidDelete(ctx, coluuid) Deletes a collection

This endpoint is used to delete an existing collection.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringCollection ID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsColuuidGet

string CollectionsColuuidGet(ctx, coluuid, optional) Get contents in a collection

This endpoint is used to get contents in a collection. If no colpath query param is passed

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringcoluuid
optional*CollectionsApiCollectionsColuuidGetOptsoptional parametersnil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a CollectionsApiCollectionsColuuidGetOpts struct

NameTypeDescriptionNotes

dir | optional.String| Directory |

Return type

string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsColuuidPost

map[string]string CollectionsColuuidPost(ctx, coluuid, contentIDs) Add contents to a collection

This endpoint adds already-pinned contents (that have ContentIDs) to a collection.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringcoluuid
contentIDs[]int32Content IDs to add to collection

Return type

map[string]string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsFsAddPost

CollectionsFsAddPost(ctx, coluuid, content, path) Add a file to a collection

This endpoint adds a file to a collection

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
coluuidstringCollection ID
contentstringContent
pathstringPath to file

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsGet

[]CollectionsCollection CollectionsGet(ctx, ) List all collections

This endpoint is used to list all collections. Whenever a user logs on estuary, it will list all collections that the user has access to. This endpoint provides a way to list all collections to the user.

Required Parameters

This endpoint does not need any parameter.

Return type

[]CollectionsCollection

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CollectionsPost

CollectionsCollection CollectionsPost(ctx, body) Create a new collection

This endpoint is used to create a new collection. A collection is a representaion of a group of objects added on the estuary. This endpoint can be used to create a new collection.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
bodyMainCreateCollectionBodyCollection name and description

Return type

CollectionsCollection

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]