Class BlueskyAgent

Namespace

idunno.Bluesky

Assembly

idunno.Bluesky.dll

An idunno.AtProto.AtProtoAgent implementation for sending requests to and receiving responses from a Bluesky service.

public class BlueskyAgent : AtProtoAgent, IDisposable

Inheritance

object

Agent

AtProtoAgent

BlueskyAgent

Implements

IDisposable

Inherited Members

AtProtoAgent.Dispose(bool)

AtProtoAgent.CreateBuilder()

AtProtoAgent.ResolveHandle(string, CancellationToken)

AtProtoAgent.ResolveHandle(Handle, CancellationToken)

AtProtoAgent.ResolveDidDocument(Did, CancellationToken)

AtProtoAgent.ResolvePds(Did, CancellationToken)

AtProtoAgent.ResolvePds(string, CancellationToken)

AtProtoAgent.ApplyWrites(ICollection<WriteOperation>, JsonSerializerOptions, Did, bool?, Cid?, string?, CancellationToken)

AtProtoAgent.CreateRecord<TRecord>(TRecord, Nsid, RecordKey?, bool?, Cid?, string?, CancellationToken)

AtProtoAgent.CreateRecord<TRecord>(TRecord, JsonSerializerOptions, Nsid, RecordKey?, bool?, Cid?, string?, CancellationToken)

AtProtoAgent.DeleteRecord(AtUri, string?, CancellationToken)

AtProtoAgent.DeleteRecord(Nsid, RecordKey, Cid?, Cid?, string?, CancellationToken)

AtProtoAgent.DeleteRecord(StrongReference, Cid?, Cid?, string?, CancellationToken)

AtProtoAgent.DeleteRecord(AtIdentifier, Nsid, RecordKey, Cid?, Cid?, string?, CancellationToken)

AtProtoAgent.PutRecord<TRecord>(TRecord, Nsid, RecordKey, bool?, Cid?, Cid?, string?, CancellationToken)

AtProtoAgent.PutRecord<TRecord>(TRecord, JsonSerializerOptions, Nsid, RecordKey, bool?, Cid?, Cid?, string?, CancellationToken)

AtProtoAgent.PutRecord<TRecord>(AtProtoRepositoryRecord<TRecord>, bool?, string?, CancellationToken)

AtProtoAgent.PutRecord<TRecord>(AtProtoRepositoryRecord<TRecord>, JsonSerializerOptions, bool?, string?, CancellationToken)

AtProtoAgent.DescribeRepo(AtIdentifier, Uri?, CancellationToken)

AtProtoAgent.GetRecord<TRecord>(AtUri, Cid?, Uri?, string?, CancellationToken)

AtProtoAgent.GetRecord<TRecord>(AtIdentifier, Nsid, RecordKey, Cid?, Uri?, string?, CancellationToken)

AtProtoAgent.GetRecord<TRecord>(AtUri, JsonSerializerOptions, Cid?, Uri?, string?, CancellationToken)

AtProtoAgent.GetRecord<TRecord>(AtIdentifier, Nsid, RecordKey, JsonSerializerOptions, Cid?, Uri?, string?, CancellationToken)

AtProtoAgent.GetRawRecord(AtUri)

AtProtoAgent.GetRawRecord(AtUri, CancellationToken)

AtProtoAgent.GetRawRecord(AtUri, Uri, CancellationToken)

AtProtoAgent.GetRawRecord(AtUri, Cid)

AtProtoAgent.GetRawRecord(AtUri, Cid, CancellationToken)

AtProtoAgent.GetRawRecord(AtUri, Cid, Uri, CancellationToken)

AtProtoAgent.GetRawRecord(AtIdentifier, Nsid, RecordKey, Cid?, Uri?, string?, CancellationToken)

AtProtoAgent.ListRecords<TRecord>(Nsid, int?, string?, bool, Uri?, string?, CancellationToken)

AtProtoAgent.ListRecords<TRecord>(AtIdentifier, Nsid, int?, string?, bool, Uri?, string?, CancellationToken)

AtProtoAgent.ListRecords<TRecord>(Nsid, JsonSerializerOptions, int?, string?, bool, Uri?, string?, CancellationToken)

AtProtoAgent.ListRecords<TRecord>(AtIdentifier, Nsid, JsonSerializerOptions, int?, string?, bool, Uri?, string?, CancellationToken)

AtProtoAgent.UploadBlob(string, string, Uri?, string?, CancellationToken)

AtProtoAgent.UploadBlob(byte[], string, Uri?, string?, CancellationToken)

AtProtoAgent.QueryLabels(IEnumerable<string>, IEnumerable<Did>?, int?, string?, Uri?, CancellationToken)

AtProtoAgent.InternalOnCredentialsUpdatedCallBack(AtProtoCredential, CancellationToken)

AtProtoAgent.CreateOAuthClient()

AtProtoAgent.CreateOAuthClient(OAuthLoginState)

AtProtoAgent.BuildOAuth2LoginUri(OAuthClient, Handle, IEnumerable<string>?, Uri?, IEnumerable<KeyValuePair<string, string>>?, Dictionary<string, string>?, bool, Func<Uri, bool, bool, ILoggerFactory?, CancellationToken, Task<bool>>?, Func<Uri, bool, bool, ILoggerFactory?, CancellationToken, Task<bool>>?, bool, bool, CancellationToken)

AtProtoAgent.ProcessOAuth2LoginResponse(OAuthClient, string, CancellationToken)

AtProtoAgent.GetServiceAuth(Uri, Nsid, TimeSpan?, CancellationToken)

AtProtoAgent.GetServiceAuth(Uri, Did, Nsid, TimeSpan?, CancellationToken)

AtProtoAgent.GetSession(CancellationToken)

AtProtoAgent.GetSession(AccessCredentials, CancellationToken)

AtProtoAgent.GetTokenEndpoint(Uri, CancellationToken)

AtProtoAgent.GetRevocationEndpoint(Uri, CancellationToken)

AtProtoAgent.Login(string, string, string?, Uri?, CancellationToken)

AtProtoAgent.Login(Handle, string, string?, Uri?, CancellationToken)

AtProtoAgent.Login(Did, string, string?, Uri?, CancellationToken)

AtProtoAgent.Login(AccessCredentials, CancellationToken)

AtProtoAgent.Login(DPoPAccessCredentials, CancellationToken)

AtProtoAgent.Logout(CancellationToken)

AtProtoAgent.RefreshCredentials(CancellationToken)

AtProtoAgent.RefreshCredentials(AtProtoCredential, CancellationToken)

AtProtoAgent.ResolveAuthorizationServer(string, CancellationToken)

AtProtoAgent.ResolveAuthorizationServer(Uri, CancellationToken)

AtProtoAgent.OnAuthenticated(AuthenticatedEventArgs)

AtProtoAgent.OnCredentialsUpdated(CredentialsUpdatedEventArgs)

AtProtoAgent.OnCredentialsUpdatedAsync(CredentialsUpdatedEventArgs, CancellationToken)

AtProtoAgent.OnTokenRefreshFailed(TokenRefreshFailedEventArgs)

AtProtoAgent.OnUnauthenticated(UnauthenticatedEventArgs)

AtProtoAgent.CreateModerationReport(Did, SubjectType, string, string?, CancellationToken)

AtProtoAgent.DescribeServer(Uri?, CancellationToken)

AtProtoAgent.LoggerFactory

AtProtoAgent.Options

AtProtoAgent.MaximumResponseSize

AtProtoAgent.Service

AtProtoAgent.OriginalService

AtProtoAgent.Credentials

AtProtoAgent.Did

AtProtoAgent.IsAuthenticated

AtProtoAgent.HasCredentials

AtProtoAgent.CredentialsUpdatedAsync

AtProtoAgent.Authenticated

AtProtoAgent.CredentialsUpdated

AtProtoAgent.TokenRefreshFailed

AtProtoAgent.Unauthenticated

Agent.Dispose(bool)

Agent.Dispose()

Agent.ConfigureHttpClient(HttpClient)

Agent.ProxyHttpMessageHandlerBuilder()

Agent.HttpClientFactory

Agent.JsonOptions

Agent.HttpClient

Agent.IsAuthenticated

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object?)

object.Equals(object?, object?)

object.ReferenceEquals(object?, object?)

object.GetHashCode()

Constructors

BlueskyAgent(BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent.

public BlueskyAgent(BlueskyAgentOptions? options = null)

Parameters

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

BlueskyAgent(ClaimsPrincipal?, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal? principal, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal?

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when principal is null.

BlueskyAgent(ClaimsIdentity, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when identity is null.

BlueskyAgent(IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent

public BlueskyAgent(IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when httpClientFactory is null.

BlueskyAgent(ClaimsPrincipal, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal principal, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when principal or httpClientFactoryis null.

BlueskyAgent(ClaimsIdentity, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsIdentity to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when identity or httpClientFactoryis null.

BlueskyAgent(BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent.

public BlueskyAgent(BlueskyAgentOptions? options = null)

Parameters

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

BlueskyAgent(ClaimsPrincipal?, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal? principal, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal?

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when principal is null.

BlueskyAgent(ClaimsIdentity, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when identity is null.

BlueskyAgent(IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent

public BlueskyAgent(IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when httpClientFactory is null.

BlueskyAgent(ClaimsPrincipal, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal principal, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when principal or httpClientFactoryis null.

BlueskyAgent(ClaimsIdentity, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsIdentity to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when identity or httpClientFactoryis null.

BlueskyAgent(BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent.

public BlueskyAgent(BlueskyAgentOptions? options = null)

Parameters

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

BlueskyAgent(ClaimsPrincipal?, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal? principal, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal?

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when principal is null.

BlueskyAgent(ClaimsIdentity, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

options BlueskyAgentOptions?

idunno.Bluesky.BlueskyAgentOptions for the use in the creation of this instance of idunno.Bluesky.BlueskyAgent.

Remarks

Setting idunno.AtProto.HttpClientOptions.CheckCertificateRevocationList to false can introduce security vulnerabilities. Only set this value to false if you are using a debugging proxy which does not support CRLs.

Exceptions

ArgumentNullException

Thrown when identity is null.

BlueskyAgent(IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent

public BlueskyAgent(IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when httpClientFactory is null.

BlueskyAgent(ClaimsPrincipal, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the principal.

public BlueskyAgent(ClaimsPrincipal principal, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

principal ClaimsPrincipal

The System.Security.Claims.ClaimsPrincipal to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when principal or httpClientFactoryis null.

BlueskyAgent(ClaimsIdentity, IHttpClientFactory, BlueskyAgentOptions?)

Creates a new instance of idunno.Bluesky.BlueskyAgent and sets the agent authentication to a idunno.AtProto.Authentication.DPoPAccessCredentials derived from the identity.

public BlueskyAgent(ClaimsIdentity identity, IHttpClientFactory httpClientFactory, BlueskyAgentOptions? options = null)

Parameters

identity ClaimsIdentity

The System.Security.Claims.ClaimsIdentity to extract authentication properties from.

httpClientFactory IHttpClientFactory

The System.Net.Http.IHttpClientFactory to use when creating System.Net.Http.HttpClients.

options BlueskyAgentOptions?

Any idunno.AtProto.AtProtoAgentOptions to configure this instance with.

Exceptions

ArgumentNullException

Thrown when identity or httpClientFactoryis null.

Properties

AuthenticatedOrUnauthenticatedServiceUri

Gets the service uri to issue commands against, based on whether the current session is authenticated.

protected Uri AuthenticatedOrUnauthenticatedServiceUri { get; }

Property Value

Uri

AuthenticatedOrUnauthenticatedServiceUri

Gets the service uri to issue commands against, based on whether the current session is authenticated.

protected Uri AuthenticatedOrUnauthenticatedServiceUri { get; }

Property Value

Uri

AuthenticatedOrUnauthenticatedServiceUri

Gets the service uri to issue commands against, based on whether the current session is authenticated.

protected Uri AuthenticatedOrUnauthenticatedServiceUri { get; }

Property Value

Uri

DraftMediaRoots

Gets the fully qualified directories draft media may be read from when a draft is posted with idunno.Bluesky.Drafts.DraftMediaPathValidation.Enforce.

public IReadOnlyList<string> DraftMediaRoots { get; }

Property Value

IReadOnlyList<string>

Remarks

This is taken from idunno.Bluesky.BlueskyAgentOptions.DraftMediaRoots when the agent is created. Entries which are empty, or which cannot be resolved to a fully qualified path, are discarded.

DraftMediaRoots

Gets the fully qualified directories draft media may be read from when a draft is posted with idunno.Bluesky.Drafts.DraftMediaPathValidation.Enforce.

public IReadOnlyList<string> DraftMediaRoots { get; }

Property Value

IReadOnlyList<string>

Remarks

This is taken from idunno.Bluesky.BlueskyAgentOptions.DraftMediaRoots when the agent is created. Entries which are empty, or which cannot be resolved to a fully qualified path, are discarded.

DraftMediaRoots

Gets the fully qualified directories draft media may be read from when a draft is posted with idunno.Bluesky.Drafts.DraftMediaPathValidation.Enforce.

public IReadOnlyList<string> DraftMediaRoots { get; }

Property Value

IReadOnlyList<string>

Remarks

This is taken from idunno.Bluesky.BlueskyAgentOptions.DraftMediaRoots when the agent is created. Entries which are empty, or which cannot be resolved to a fully qualified path, are discarded.

FacetExtractor

Gets the configured idunno.Bluesky.RichText.IFacetExtractor for this instance.

public IFacetExtractor FacetExtractor { get; }

Property Value

IFacetExtractor

FacetExtractor

Gets the configured idunno.Bluesky.RichText.IFacetExtractor for this instance.

public IFacetExtractor FacetExtractor { get; }

Property Value

IFacetExtractor

FacetExtractor

Gets the configured idunno.Bluesky.RichText.IFacetExtractor for this instance.

public IFacetExtractor FacetExtractor { get; }

Property Value

IFacetExtractor

ReadOnlyServiceUri

Gets the service uri used to issue read only commands against.

protected Uri ReadOnlyServiceUri { get; init; }

Property Value

Uri

ReadOnlyServiceUri

Gets the service uri used to issue read only commands against.

protected Uri ReadOnlyServiceUri { get; init; }

Property Value

Uri

ReadOnlyServiceUri

Gets the service uri used to issue read only commands against.

protected Uri ReadOnlyServiceUri { get; init; }

Property Value

Uri

Methods

AbortUpload(string, CancellationToken)

Abort an upload only while it is created, releasing its quota reservation immediately. Terminal sessions are unchanged and return their terminal outcome. A finishing session returns UploadNotReady.

public Task<AtProtoHttpResult<AbortUploadResponse>> AbortUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to abort.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AbortUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

AbortUpload(string, CancellationToken)

Abort an upload only while it is created, releasing its quota reservation immediately. Terminal sessions are unchanged and return their terminal outcome. A finishing session returns UploadNotReady.

public Task<AtProtoHttpResult<AbortUploadResponse>> AbortUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to abort.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AbortUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

AbortUpload(string, CancellationToken)

Abort an upload only while it is created, releasing its quota reservation immediately. Terminal sessions are unchanged and return their terminal outcome. A finishing session returns UploadNotReady.

public Task<AtProtoHttpResult<AbortUploadResponse>> AbortUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to abort.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AbortUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

AcceptConversation(string, CancellationToken)

Accepts the conversation specified by the conversationId for the authenticated user.

public Task<AtProtoHttpResult<AcceptConversationResponse>> AcceptConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to accept.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AcceptConversationResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AcceptConversation(string, CancellationToken)

Accepts the conversation specified by the conversationId for the authenticated user.

public Task<AtProtoHttpResult<AcceptConversationResponse>> AcceptConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to accept.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AcceptConversationResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AcceptConversation(string, CancellationToken)

Accepts the conversation specified by the conversationId for the authenticated user.

public Task<AtProtoHttpResult<AcceptConversationResponse>> AcceptConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to accept.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AcceptConversationResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddMembersToGroup(string, IEnumerable<Did>, CancellationToken)

Adds members to a group conversation.

public Task<AtProtoHttpResult<AddMembersResponse>> AddMembersToGroup(string conversationId, IEnumerable<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

members IEnumerable<Did>

The members to add.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<AddMembersResponse>>

The result of the add members operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the members collection is null.

ArgumentOutOfRangeException

Thrown when the members collection is empty.

AddMembersToGroup(string, IEnumerable<Did>, CancellationToken)

Adds members to a group conversation.

public Task<AtProtoHttpResult<AddMembersResponse>> AddMembersToGroup(string conversationId, IEnumerable<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

members IEnumerable<Did>

The members to add.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<AddMembersResponse>>

The result of the add members operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the members collection is null.

ArgumentOutOfRangeException

Thrown when the members collection is empty.

AddMembersToGroup(string, IEnumerable<Did>, CancellationToken)

Adds members to a group conversation.

public Task<AtProtoHttpResult<AddMembersResponse>> AddMembersToGroup(string conversationId, IEnumerable<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

members IEnumerable<Did>

The members to add.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<AddMembersResponse>>

The result of the add members operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the members collection is null.

ArgumentOutOfRangeException

Thrown when the members collection is empty.

AddPostGate(AtUri, ICollection<PostGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates the specified idunno.Bluesky.Feed.Gates.PostGate record in the current user's repository.

public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(AtUri post, ICollection<PostGateRule>? rules = null, ICollection<AtUri>? detachedEmbeddingUris = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the post to create the gate against

rules ICollection<PostGateRule>?

The collection of idunno.Bluesky.Feed.Gates.PostGateRules the gate will contain.

detachedEmbeddingUris ICollection<AtUri>?

The collection of idunno.AtProto.AtUris of posts that the post will detach from (removing itself as a quoted post).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post is not owned by the current user.

ArgumentOutOfRangeException

Thrown when rules is empty or has larger than the maximum number of rules allowed, or when detachedEmbeddingUris has larger than the number of uris allowed.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddPostGate(PostGate, CancellationToken)

Creates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(PostGate postGate, CancellationToken cancellationToken = default)

Parameters

postGate PostGate

The postGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddPostGate(AtUri, ICollection<PostGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates the specified idunno.Bluesky.Feed.Gates.PostGate record in the current user's repository.

public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(AtUri post, ICollection<PostGateRule>? rules = null, ICollection<AtUri>? detachedEmbeddingUris = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the post to create the gate against

rules ICollection<PostGateRule>?

The collection of idunno.Bluesky.Feed.Gates.PostGateRules the gate will contain.

detachedEmbeddingUris ICollection<AtUri>?

The collection of idunno.AtProto.AtUris of posts that the post will detach from (removing itself as a quoted post).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post is not owned by the current user.

ArgumentOutOfRangeException

Thrown when rules is empty or has larger than the maximum number of rules allowed, or when detachedEmbeddingUris has larger than the number of uris allowed.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddPostGate(PostGate, CancellationToken)

Creates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(PostGate postGate, CancellationToken cancellationToken = default)

Parameters

postGate PostGate

The postGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddPostGate(AtUri, ICollection<PostGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates the specified idunno.Bluesky.Feed.Gates.PostGate record in the current user's repository.

public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(AtUri post, ICollection<PostGateRule>? rules = null, ICollection<AtUri>? detachedEmbeddingUris = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the post to create the gate against

rules ICollection<PostGateRule>?

The collection of idunno.Bluesky.Feed.Gates.PostGateRules the gate will contain.

detachedEmbeddingUris ICollection<AtUri>?

The collection of idunno.AtProto.AtUris of posts that the post will detach from (removing itself as a quoted post).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post is not owned by the current user.

ArgumentOutOfRangeException

Thrown when rules is empty or has larger than the maximum number of rules allowed, or when detachedEmbeddingUris has larger than the number of uris allowed.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddPostGate(PostGate, CancellationToken)

Creates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddPostGate(PostGate postGate, CancellationToken cancellationToken = default)

Parameters

postGate PostGate

The postGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddReaction(string, string, string, CancellationToken)

Adds a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> AddReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when any of conversationId, messageId or value are null or whitespace.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1, or is longer than idunno.Bluesky.Maximum.ReactionLengthInBytes UTF-8 bytes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddReaction(string, string, string, CancellationToken)

Adds a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> AddReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when any of conversationId, messageId or value are null or whitespace.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1, or is longer than idunno.Bluesky.Maximum.ReactionLengthInBytes UTF-8 bytes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddReaction(string, string, string, CancellationToken)

Adds a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> AddReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when any of conversationId, messageId or value are null or whitespace.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1, or is longer than idunno.Bluesky.Maximum.ReactionLengthInBytes UTF-8 bytes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddThreadGate(AtUri, ICollection<ThreadGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates a thread gate record in the current user's repository for the specified post

public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(AtUri post, ICollection<ThreadGateRule>? rules = null, ICollection<AtUri>? hiddenReplies = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the thread to be gated.

rules ICollection<ThreadGateRule>?

The list of rules for replies to the specified post.

hiddenReplies ICollection<AtUri>?

A list of reply idunno.AtProto.AtUris that will be hidden for post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when posthas a null repo, does not point to a post record or the current user does not own the record pointed to.

ArgumentOutOfRangeException

Thrown when rules or hiddenReplies have more than the maximum number of entries.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddThreadGate(ThreadGate, CancellationToken)

Creates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(ThreadGate threadGate, CancellationToken cancellationToken = default)

Parameters

threadGate ThreadGate

The threadGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when threadGate's post is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddThreadGate(AtUri, ICollection<ThreadGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates a thread gate record in the current user's repository for the specified post

public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(AtUri post, ICollection<ThreadGateRule>? rules = null, ICollection<AtUri>? hiddenReplies = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the thread to be gated.

rules ICollection<ThreadGateRule>?

The list of rules for replies to the specified post.

hiddenReplies ICollection<AtUri>?

A list of reply idunno.AtProto.AtUris that will be hidden for post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when posthas a null repo, does not point to a post record or the current user does not own the record pointed to.

ArgumentOutOfRangeException

Thrown when rules or hiddenReplies have more than the maximum number of entries.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddThreadGate(ThreadGate, CancellationToken)

Creates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(ThreadGate threadGate, CancellationToken cancellationToken = default)

Parameters

threadGate ThreadGate

The threadGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when threadGate's post is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddThreadGate(AtUri, ICollection<ThreadGateRule>?, ICollection<AtUri>?, CancellationToken)

Creates a thread gate record in the current user's repository for the specified post

public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(AtUri post, ICollection<ThreadGateRule>? rules = null, ICollection<AtUri>? hiddenReplies = null, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri of the thread to be gated.

rules ICollection<ThreadGateRule>?

The list of rules for replies to the specified post.

hiddenReplies ICollection<AtUri>?

A list of reply idunno.AtProto.AtUris that will be hidden for post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when posthas a null repo, does not point to a post record or the current user does not own the record pointed to.

ArgumentOutOfRangeException

Thrown when rules or hiddenReplies have more than the maximum number of entries.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddThreadGate(ThreadGate, CancellationToken)

Creates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddThreadGate(ThreadGate threadGate, CancellationToken cancellationToken = default)

Parameters

threadGate ThreadGate

The threadGate record to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when threadGate's post is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

AddToList(AtUri, Did, CancellationToken)

Adds the did to the specified uri.

public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the did to.

did Did

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or did is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddToList(AtUri, Handle, CancellationToken)

Adds the handle to the specified uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the handle to.

handle Handle

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or handle is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddToList(AtUri, Did, CancellationToken)

Adds the did to the specified uri.

public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the did to.

did Did

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or did is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddToList(AtUri, Handle, CancellationToken)

Adds the handle to the specified uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the handle to.

handle Handle

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or handle is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddToList(AtUri, Did, CancellationToken)

Adds the did to the specified uri.

public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the did to.

did Did

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or did is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

AddToList(AtUri, Handle, CancellationToken)

Adds the handle to the specified uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> AddToList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to add the handle to.

handle Handle

The idunno.AtProto.Did of the actor to add to the list.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, its collection property, or handle is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ApproveJoinGroupRequest(string, Did, CancellationToken)

Approves the join request of a user, specified by member, to a group conversation, specified by conversationId.

public Task<AtProtoHttpResult<ApproveJoinResponse>> ApproveJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

member Did

The member to approve.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<ApproveJoinResponse>>

The result of the approve join operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the member is null.

ApproveJoinGroupRequest(string, Did, CancellationToken)

Approves the join request of a user, specified by member, to a group conversation, specified by conversationId.

public Task<AtProtoHttpResult<ApproveJoinResponse>> ApproveJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

member Did

The member to approve.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<ApproveJoinResponse>>

The result of the approve join operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the member is null.

ApproveJoinGroupRequest(string, Did, CancellationToken)

Approves the join request of a user, specified by member, to a group conversation, specified by conversationId.

public Task<AtProtoHttpResult<ApproveJoinResponse>> ApproveJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

member Did

The member to approve.

cancellationToken CancellationToken

A token to cancel the operation.

Returns

Task<AtProtoHttpResult<ApproveJoinResponse>>

The result of the approve join operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when the conversation ID is null or whitespace.

ArgumentNullException

Thrown when the member is null.

Block(Did, CancellationToken)

Creates a block record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Block(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Block(Did, CancellationToken)

Creates a block record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Block(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Block(Did, CancellationToken)

Creates a block record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Block(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

BlockModList(AtUri, CancellationToken)

Creates a block record in the authenticated user's repo for every actor in the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> BlockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

BlockModList(AtUri, CancellationToken)

Creates a block record in the authenticated user's repo for every actor in the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> BlockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

BlockModList(AtUri, CancellationToken)

Creates a block record in the authenticated user's repo for every actor in the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> BlockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to block.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

BuildAtUriFromBlueskyWebUri(Uri, CancellationToken)

Generates an idunno.AtProto.AtUri from the uri. This idunno.AtProto.AtUri is very dependent on the Bluesky web client and its format is subject to change.

public Task<AtUri> BuildAtUriFromBlueskyWebUri(Uri uri, CancellationToken cancellationToken = default)

Parameters

uri Uri

A URI from the Bluesky web client.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtUri>

An idunno.AtProto.AtUri corresponding to the resource the Bluesky web client uri.

Remarks

This method makes outgoing web requests to resolve the handle in a Bluesky uri to a idunno.AtProto.Did.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentException

Thrown when uri is in an unexpected format.

HandleResolutionException

Thrown when the handle in uri could not be resolved to a idunno.AtProto.Did.

BuildAtUriFromBlueskyWebUri(Uri, CancellationToken)

Generates an idunno.AtProto.AtUri from the uri. This idunno.AtProto.AtUri is very dependent on the Bluesky web client and its format is subject to change.

public Task<AtUri> BuildAtUriFromBlueskyWebUri(Uri uri, CancellationToken cancellationToken = default)

Parameters

uri Uri

A URI from the Bluesky web client.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtUri>

An idunno.AtProto.AtUri corresponding to the resource the Bluesky web client uri.

Remarks

This method makes outgoing web requests to resolve the handle in a Bluesky uri to a idunno.AtProto.Did.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentException

Thrown when uri is in an unexpected format.

HandleResolutionException

Thrown when the handle in uri could not be resolved to a idunno.AtProto.Did.

BuildAtUriFromBlueskyWebUri(Uri, CancellationToken)

Generates an idunno.AtProto.AtUri from the uri. This idunno.AtProto.AtUri is very dependent on the Bluesky web client and its format is subject to change.

public Task<AtUri> BuildAtUriFromBlueskyWebUri(Uri uri, CancellationToken cancellationToken = default)

Parameters

uri Uri

A URI from the Bluesky web client.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtUri>

An idunno.AtProto.AtUri corresponding to the resource the Bluesky web client uri.

Remarks

This method makes outgoing web requests to resolve the handle in a Bluesky uri to a idunno.AtProto.Did.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentException

Thrown when uri is in an unexpected format.

HandleResolutionException

Thrown when the handle in uri could not be resolved to a idunno.AtProto.Did.

BuildBlueskyPostUriFromAtUri(AtUri)

Generates an Bluesky Web URI from the specified atUri, if the atUri is in the app.bsky.feed.post collection. This Uri is very dependent on the Bluesky web client and its format is subject to change.

public static Uri BuildBlueskyPostUriFromAtUri(AtUri atUri)

Parameters

atUri AtUri

The idunno.AtProto.AtUri to generate a web URI for.

Returns

Uri

A URI for the Bluesky Web Client which will display the record specified by the atUri.

Exceptions

ArgumentNullException

Thrown when atUri is null.

ArgumentException

Thrown when atUri is in an unexpected format or collection.

BuildBlueskyPostUriFromAtUri(AtUri)

Generates an Bluesky Web URI from the specified atUri, if the atUri is in the app.bsky.feed.post collection. This Uri is very dependent on the Bluesky web client and its format is subject to change.

public static Uri BuildBlueskyPostUriFromAtUri(AtUri atUri)

Parameters

atUri AtUri

The idunno.AtProto.AtUri to generate a web URI for.

Returns

Uri

A URI for the Bluesky Web Client which will display the record specified by the atUri.

Exceptions

ArgumentNullException

Thrown when atUri is null.

ArgumentException

Thrown when atUri is in an unexpected format or collection.

BuildBlueskyPostUriFromAtUri(AtUri)

Generates an Bluesky Web URI from the specified atUri, if the atUri is in the app.bsky.feed.post collection. This Uri is very dependent on the Bluesky web client and its format is subject to change.

public static Uri BuildBlueskyPostUriFromAtUri(AtUri atUri)

Parameters

atUri AtUri

The idunno.AtProto.AtUri to generate a web URI for.

Returns

Uri

A URI for the Bluesky Web Client which will display the record specified by the atUri.

Exceptions

ArgumentNullException

Thrown when atUri is null.

ArgumentException

Thrown when atUri is in an unexpected format or collection.

CreateBlueskyRecord<TRecord>(TRecord, Nsid, RecordKey?, bool?, Cid?, string?, CancellationToken)

Creates a record in the specified collection belonging to the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateBlueskyRecord<TRecord>(TRecord record, Nsid collection, RecordKey? rKey = null, bool? validate = true, Cid? swapCommit = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

record TRecord

The record to be created.

collection Nsid

The collection the record should be created in.

rKey RecordKey?

An optional idunno.AtProto.RecordKey to create the record with.

validate bool?

Sets a flag indicating what validation will be performed, if any.

A value of true requires lexicon schema validation of record data.

A value of false will skip Lexicon schema validation of record data.

A value of null to validate record data only for known lexicons.

Defaults to true.

swapCommit Cid?

Compare and swap with the previous commit by CID.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to create.

Exceptions

ArgumentNullException

Thrown when record or collection is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateBlueskyRecord<TRecord>(TRecord, Nsid, RecordKey?, bool?, Cid?, string?, CancellationToken)

Creates a record in the specified collection belonging to the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateBlueskyRecord<TRecord>(TRecord record, Nsid collection, RecordKey? rKey = null, bool? validate = true, Cid? swapCommit = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

record TRecord

The record to be created.

collection Nsid

The collection the record should be created in.

rKey RecordKey?

An optional idunno.AtProto.RecordKey to create the record with.

validate bool?

Sets a flag indicating what validation will be performed, if any.

A value of true requires lexicon schema validation of record data.

A value of false will skip Lexicon schema validation of record data.

A value of null to validate record data only for known lexicons.

Defaults to true.

swapCommit Cid?

Compare and swap with the previous commit by CID.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to create.

Exceptions

ArgumentNullException

Thrown when record or collection is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateBlueskyRecord<TRecord>(TRecord, Nsid, RecordKey?, bool?, Cid?, string?, CancellationToken)

Creates a record in the specified collection belonging to the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateBlueskyRecord<TRecord>(TRecord record, Nsid collection, RecordKey? rKey = null, bool? validate = true, Cid? swapCommit = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

record TRecord

The record to be created.

collection Nsid

The collection the record should be created in.

rKey RecordKey?

An optional idunno.AtProto.RecordKey to create the record with.

validate bool?

Sets a flag indicating what validation will be performed, if any.

A value of true requires lexicon schema validation of record data.

A value of false will skip Lexicon schema validation of record data.

A value of null to validate record data only for known lexicons.

Defaults to true.

swapCommit Cid?

Compare and swap with the previous commit by CID.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to create.

Exceptions

ArgumentNullException

Thrown when record or collection is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateBookmark(AtUri, Cid, CancellationToken)

Creates a bookmark on the specified account from the specified uri and cid. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to bookmark.

cid Cid

The idunno.AtProto.Cid of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or cid are null.

ArgumentOutOfRangeException

Thrown when uri does not point to a post.

AuthenticationRequiredException

Thrown if the agent is not authenticated.

CreateBookmark(StrongReference, CancellationToken)

Creates a bookmark on the specified account from the specified strongReference. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when strongReference is null.

CreateBookmark(AtUri, Cid, CancellationToken)

Creates a bookmark on the specified account from the specified uri and cid. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to bookmark.

cid Cid

The idunno.AtProto.Cid of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or cid are null.

ArgumentOutOfRangeException

Thrown when uri does not point to a post.

AuthenticationRequiredException

Thrown if the agent is not authenticated.

CreateBookmark(StrongReference, CancellationToken)

Creates a bookmark on the specified account from the specified strongReference. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when strongReference is null.

CreateBookmark(AtUri, Cid, CancellationToken)

Creates a bookmark on the specified account from the specified uri and cid. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to bookmark.

cid Cid

The idunno.AtProto.Cid of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or cid are null.

ArgumentOutOfRangeException

Thrown when uri does not point to a post.

AuthenticationRequiredException

Thrown if the agent is not authenticated.

CreateBookmark(StrongReference, CancellationToken)

Creates a bookmark on the specified account from the specified strongReference. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> CreateBookmark(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to bookmark.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when strongReference is null.

CreateBuilder()

Creates a new idunno.Bluesky.BlueskyAgentBuilder.

public static BlueskyAgentBuilder CreateBuilder()

Returns

BlueskyAgentBuilder

A new idunno.Bluesky.BlueskyAgentBuilder

CreateBuilder()

Creates a new idunno.Bluesky.BlueskyAgentBuilder.

public static BlueskyAgentBuilder CreateBuilder()

Returns

BlueskyAgentBuilder

A new idunno.Bluesky.BlueskyAgentBuilder

CreateBuilder()

Creates a new idunno.Bluesky.BlueskyAgentBuilder.

public static BlueskyAgentBuilder CreateBuilder()

Returns

BlueskyAgentBuilder

A new idunno.Bluesky.BlueskyAgentBuilder

CreateDraft(Draft, CancellationToken)

Creates a draft for the authenticated user.

public Task<AtProtoHttpResult<TimestampIdentifier>> CreateDraft(Draft draft, CancellationToken cancellationToken = default)

Parameters

draft Draft

The draft to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TimestampIdentifier>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown if draft is null.

CreateDraft(Draft, CancellationToken)

Creates a draft for the authenticated user.

public Task<AtProtoHttpResult<TimestampIdentifier>> CreateDraft(Draft draft, CancellationToken cancellationToken = default)

Parameters

draft Draft

The draft to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TimestampIdentifier>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown if draft is null.

CreateDraft(Draft, CancellationToken)

Creates a draft for the authenticated user.

public Task<AtProtoHttpResult<TimestampIdentifier>> CreateDraft(Draft draft, CancellationToken cancellationToken = default)

Parameters

draft Draft

The draft to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TimestampIdentifier>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown if draft is null.

CreateGroup(ICollection<Did>, string, CancellationToken)

Creates a group conversation and invites members to join it.

public Task<AtProtoHttpResult<CreateGroupResponse>> CreateGroup(ICollection<Did> members, string name, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The members to add to the group. The owner is automatically added. Implementations may enforce a lower maximum than the 10,000-item schema limit; Bluesky currently supports up to 100 total members. If the owner is included in this list, the list may contain up to the implementation's total member limit. Otherwise, it may contain one fewer.

name string

The name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentException

Thrown when name is null or empty.

ArgumentOutOfRangeException

Thrown when members is empty or exceeds the maximum number of members, or when name exceeds the maximum length.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateGroup(ICollection<Did>, string, CancellationToken)

Creates a group conversation and invites members to join it.

public Task<AtProtoHttpResult<CreateGroupResponse>> CreateGroup(ICollection<Did> members, string name, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The members to add to the group. The owner is automatically added. Implementations may enforce a lower maximum than the 10,000-item schema limit; Bluesky currently supports up to 100 total members. If the owner is included in this list, the list may contain up to the implementation's total member limit. Otherwise, it may contain one fewer.

name string

The name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentException

Thrown when name is null or empty.

ArgumentOutOfRangeException

Thrown when members is empty or exceeds the maximum number of members, or when name exceeds the maximum length.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateGroup(ICollection<Did>, string, CancellationToken)

Creates a group conversation and invites members to join it.

public Task<AtProtoHttpResult<CreateGroupResponse>> CreateGroup(ICollection<Did> members, string name, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The members to add to the group. The owner is automatically added. Implementations may enforce a lower maximum than the 10,000-item schema limit; Bluesky currently supports up to 100 total members. If the owner is included in this list, the list may contain up to the implementation's total member limit. Otherwise, it may contain one fewer.

name string

The name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentException

Thrown when name is null or empty.

ArgumentOutOfRangeException

Thrown when members is empty or exceeds the maximum number of members, or when name exceeds the maximum length.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateJoinGroupLink(string, bool, string, CancellationToken)

Creates a join link for a group conversation.

public Task<AtProtoHttpResult<CreateJoinLinkResponse>> CreateJoinGroupLink(string conversationId, bool requireApproval, string joinRule, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to create the link for.

requireApproval bool

Indicates whether approval is required to join the conversation.

joinRule string

The rule for joining the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or joinRule is null.

ArgumentException

Thrown when conversationId or joinRule is empty.

CreateJoinGroupLink(string, bool, string, CancellationToken)

Creates a join link for a group conversation.

public Task<AtProtoHttpResult<CreateJoinLinkResponse>> CreateJoinGroupLink(string conversationId, bool requireApproval, string joinRule, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to create the link for.

requireApproval bool

Indicates whether approval is required to join the conversation.

joinRule string

The rule for joining the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or joinRule is null.

ArgumentException

Thrown when conversationId or joinRule is empty.

CreateJoinGroupLink(string, bool, string, CancellationToken)

Creates a join link for a group conversation.

public Task<AtProtoHttpResult<CreateJoinLinkResponse>> CreateJoinGroupLink(string conversationId, bool requireApproval, string joinRule, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to create the link for.

requireApproval bool

Indicates whether approval is required to join the conversation.

joinRule string

The rule for joining the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or joinRule is null.

ArgumentException

Thrown when conversationId or joinRule is empty.

CreateList(List, CancellationToken)

Creates a idunno.Bluesky.Graph.List.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateList(List list, CancellationToken cancellationToken = default)

Parameters

list List

The idunno.Bluesky.Graph.List to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateList(List, CancellationToken)

Creates a idunno.Bluesky.Graph.List.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateList(List list, CancellationToken cancellationToken = default)

Parameters

list List

The idunno.Bluesky.Graph.List to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateList(List, CancellationToken)

Creates a idunno.Bluesky.Graph.List.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateList(List list, CancellationToken cancellationToken = default)

Parameters

list List

The idunno.Bluesky.Graph.List to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateLiveStatus(Uri, string, string, Blob?, int?, CancellationToken)

Creates a profile status for the current authenticated user to indicate a live stream.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateLiveStatus(Uri uri, string title, string description, Blob? previewBlob = null, int? durationMinutes = null, CancellationToken cancellationToken = default)

Parameters

uri Uri

The uri of the live stream.

title string

The title of the stream.

description string

A description of the stream.

previewBlob Blob?

An optional idunno.AtProto.Blob containing a preview image for the stream.

durationMinutes int?

The optional duration of the stream in minutes.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, title, or description is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateLiveStatus(Uri, string, string, Blob?, int?, CancellationToken)

Creates a profile status for the current authenticated user to indicate a live stream.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateLiveStatus(Uri uri, string title, string description, Blob? previewBlob = null, int? durationMinutes = null, CancellationToken cancellationToken = default)

Parameters

uri Uri

The uri of the live stream.

title string

The title of the stream.

description string

A description of the stream.

previewBlob Blob?

An optional idunno.AtProto.Blob containing a preview image for the stream.

durationMinutes int?

The optional duration of the stream in minutes.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, title, or description is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateLiveStatus(Uri, string, string, Blob?, int?, CancellationToken)

Creates a profile status for the current authenticated user to indicate a live stream.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateLiveStatus(Uri uri, string title, string description, Blob? previewBlob = null, int? durationMinutes = null, CancellationToken cancellationToken = default)

Parameters

uri Uri

The uri of the live stream.

title string

The title of the stream.

description string

A description of the stream.

previewBlob Blob?

An optional idunno.AtProto.Blob containing a preview image for the stream.

durationMinutes int?

The optional duration of the stream in minutes.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri, title, or description is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateModerationReport(Did, SubjectType, ReportType, string?, CancellationToken)

Creates and sends a moderation report to the specified labelerDid.

public Task<AtProtoHttpResult<ModerationReport>> CreateModerationReport(Did labelerDid, SubjectType subject, ReportType reportType, string? reason, CancellationToken cancellationToken = default)

Parameters

labelerDid Did

The idunno.AtProto.Did of the labeler to report to.

subject SubjectType

The subject of the report, a idunno.AtProto.Repo.StrongReference to a record, or a idunno.AtProto.Admin.RepoReference for an actor.

reportType ReportType

The reason for the report.

reason string?

Any notes to justify the report.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ModerationReport>>

The task object representing the asynchronous operation.

Remarks

Clients should not send reports to Labelers which do not match the subject and report type metadata in their declaration record. Labeler declarations can be retrieved with idunno.Bluesky.BlueskyAgent.GetLabelerDeclaration(idunno.AtProto.Did,System.Threading.CancellationToken).

Exceptions

ArgumentNullException

Thrown when labelerDid or subject is null.

ArgumentOutOfRangeException

Thrown when reportType is not a defined idunno.Bluesky.Moderation.ReportType, or when reason is not null and is longer than 20000 bytes or 2000 graphemes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateModerationReport(Did, SubjectType, ReportType, string?, CancellationToken)

Creates and sends a moderation report to the specified labelerDid.

public Task<AtProtoHttpResult<ModerationReport>> CreateModerationReport(Did labelerDid, SubjectType subject, ReportType reportType, string? reason, CancellationToken cancellationToken = default)

Parameters

labelerDid Did

The idunno.AtProto.Did of the labeler to report to.

subject SubjectType

The subject of the report, a idunno.AtProto.Repo.StrongReference to a record, or a idunno.AtProto.Admin.RepoReference for an actor.

reportType ReportType

The reason for the report.

reason string?

Any notes to justify the report.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ModerationReport>>

The task object representing the asynchronous operation.

Remarks

Clients should not send reports to Labelers which do not match the subject and report type metadata in their declaration record. Labeler declarations can be retrieved with idunno.Bluesky.BlueskyAgent.GetLabelerDeclaration(idunno.AtProto.Did,System.Threading.CancellationToken).

Exceptions

ArgumentNullException

Thrown when labelerDid or subject is null.

ArgumentOutOfRangeException

Thrown when reportType is not a defined idunno.Bluesky.Moderation.ReportType, or when reason is not null and is longer than 20000 bytes or 2000 graphemes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateModerationReport(Did, SubjectType, ReportType, string?, CancellationToken)

Creates and sends a moderation report to the specified labelerDid.

public Task<AtProtoHttpResult<ModerationReport>> CreateModerationReport(Did labelerDid, SubjectType subject, ReportType reportType, string? reason, CancellationToken cancellationToken = default)

Parameters

labelerDid Did

The idunno.AtProto.Did of the labeler to report to.

subject SubjectType

The subject of the report, a idunno.AtProto.Repo.StrongReference to a record, or a idunno.AtProto.Admin.RepoReference for an actor.

reportType ReportType

The reason for the report.

reason string?

Any notes to justify the report.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ModerationReport>>

The task object representing the asynchronous operation.

Remarks

Clients should not send reports to Labelers which do not match the subject and report type metadata in their declaration record. Labeler declarations can be retrieved with idunno.Bluesky.BlueskyAgent.GetLabelerDeclaration(idunno.AtProto.Did,System.Threading.CancellationToken).

Exceptions

ArgumentNullException

Thrown when labelerDid or subject is null.

ArgumentOutOfRangeException

Thrown when reportType is not a defined idunno.Bluesky.Moderation.ReportType, or when reason is not null and is longer than 20000 bytes or 2000 graphemes.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateOpenGraphEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator class, configured to use the agent.

public OpenGraphEmbeddedCardGenerator CreateOpenGraphEmbeddedCardGenerator()

Returns

OpenGraphEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator.

CreateOpenGraphEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator class, configured to use the agent.

public OpenGraphEmbeddedCardGenerator CreateOpenGraphEmbeddedCardGenerator()

Returns

OpenGraphEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator.

CreateOpenGraphEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator class, configured to use the agent.

public OpenGraphEmbeddedCardGenerator CreateOpenGraphEmbeddedCardGenerator()

Returns

OpenGraphEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.OpenGraphEmbeddedCardGenerator.

CreateProfile(Profile, CancellationToken)

Creates a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateProfile(Profile)

Creates a idunno.Bluesky.Actor.Profile for the current user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

CreateProfile(Profile, CancellationToken)

Creates a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateProfile(Profile)

Creates a idunno.Bluesky.Actor.Profile for the current user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

CreateProfile(Profile, CancellationToken)

Creates a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateProfile(Profile)

Creates a idunno.Bluesky.Actor.Profile for the current user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to create.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

CreateReferenceListOptOut(AtUri, CancellationToken)

Creates a reference list opt out record for the given list, requesting that its author be omitted from the public presentation of a reference list.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateReferenceListOptOut(AtUri subject, CancellationToken cancellationToken = default)

Parameters

subject AtUri

Canonical, idunno.AtProto.Did-based idunno.AtProto.AtUri of the app.bsky.graph.list record from which the author requests omission.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the provided subject is not a valid list record.

CreateReferenceListOptOut(AtUri, CancellationToken)

Creates a reference list opt out record for the given list, requesting that its author be omitted from the public presentation of a reference list.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateReferenceListOptOut(AtUri subject, CancellationToken cancellationToken = default)

Parameters

subject AtUri

Canonical, idunno.AtProto.Did-based idunno.AtProto.AtUri of the app.bsky.graph.list record from which the author requests omission.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the provided subject is not a valid list record.

CreateReferenceListOptOut(AtUri, CancellationToken)

Creates a reference list opt out record for the given list, requesting that its author be omitted from the public presentation of a reference list.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateReferenceListOptOut(AtUri subject, CancellationToken cancellationToken = default)

Parameters

subject AtUri

Canonical, idunno.AtProto.Did-based idunno.AtProto.AtUri of the app.bsky.graph.list record from which the author requests omission.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the provided subject is not a valid list record.

CreateStandardSiteEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator class, configured to use the agent.

public StandardSiteEmbeddedCardGenerator CreateStandardSiteEmbeddedCardGenerator()

Returns

StandardSiteEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator.

CreateStandardSiteEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator class, configured to use the agent.

public StandardSiteEmbeddedCardGenerator CreateStandardSiteEmbeddedCardGenerator()

Returns

StandardSiteEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator.

CreateStandardSiteEmbeddedCardGenerator()

Returns a new instance of a idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator class, configured to use the agent.

public StandardSiteEmbeddedCardGenerator CreateStandardSiteEmbeddedCardGenerator()

Returns

StandardSiteEmbeddedCardGenerator

A new instance of idunno.Bluesky.Embed.StandardSiteEmbeddedCardGenerator.

CreateStatus(Status, CancellationToken)

Creates a profile status for the current authenticated user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateStatus(Status status, CancellationToken cancellationToken = default)

Parameters

status Status

The status to set

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when status is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateStatus(Status, CancellationToken)

Creates a profile status for the current authenticated user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateStatus(Status status, CancellationToken cancellationToken = default)

Parameters

status Status

The status to set

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when status is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

CreateStatus(Status, CancellationToken)

Creates a profile status for the current authenticated user.

public Task<AtProtoHttpResult<CreateRecordResult>> CreateStatus(Status status, CancellationToken cancellationToken = default)

Parameters

status Status

The status to set

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when status is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteBlock(AtUri, CancellationToken)

Deletes the Bluesky block record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky block record, or its RecordKey is null.

DeleteBlock(StrongReference, CancellationToken)

Deletes the Bluesky block record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteBlock(AtUri, CancellationToken)

Deletes the Bluesky block record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky block record, or its RecordKey is null.

DeleteBlock(StrongReference, CancellationToken)

Deletes the Bluesky block record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteBlock(AtUri, CancellationToken)

Deletes the Bluesky block record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky block record, or its RecordKey is null.

DeleteBlock(StrongReference, CancellationToken)

Deletes the Bluesky block record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteBlock(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the block record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteBookmark(AtUri, CancellationToken)

Deletes a bookmark on the specified account for the specified uri. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteBookmark(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the bookmark for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when uri, or its Collection property is null.

ArgumentOutOfRangeException

Thrown when uri's Collection property does not point to a post.

DeleteBookmark(AtUri, CancellationToken)

Deletes a bookmark on the specified account for the specified uri. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteBookmark(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the bookmark for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when uri, or its Collection property is null.

ArgumentOutOfRangeException

Thrown when uri's Collection property does not point to a post.

DeleteBookmark(AtUri, CancellationToken)

Deletes a bookmark on the specified account for the specified uri. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteBookmark(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the bookmark for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentNullException

Thrown when uri, or its Collection property is null.

ArgumentOutOfRangeException

Thrown when uri's Collection property does not point to a post.

DeleteContentVisibilityDeclaration(Cid?, CancellationToken)

Deletes the current authenticated user's content visibility record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteContentVisibilityDeclaration(Cid? swapCommit = null, CancellationToken cancellationToken = default)

Parameters

swapCommit Cid?

Specified if the operation should compare and swap with the previous commit by cid.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteContentVisibilityDeclaration(Cid?, CancellationToken)

Deletes the current authenticated user's content visibility record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteContentVisibilityDeclaration(Cid? swapCommit = null, CancellationToken cancellationToken = default)

Parameters

swapCommit Cid?

Specified if the operation should compare and swap with the previous commit by cid.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteContentVisibilityDeclaration(Cid?, CancellationToken)

Deletes the current authenticated user's content visibility record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteContentVisibilityDeclaration(Cid? swapCommit = null, CancellationToken cancellationToken = default)

Parameters

swapCommit Cid?

Specified if the operation should compare and swap with the previous commit by cid.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteDraft(TimestampIdentifier, CancellationToken)

Deletes a draft by ID.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteDraft(TimestampIdentifier draftId, CancellationToken cancellationToken = default)

Parameters

draftId TimestampIdentifier

The ID of the draft to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftId is null.

DeleteDraft(TimestampIdentifier, CancellationToken)

Deletes a draft by ID.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteDraft(TimestampIdentifier draftId, CancellationToken cancellationToken = default)

Parameters

draftId TimestampIdentifier

The ID of the draft to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftId is null.

DeleteDraft(TimestampIdentifier, CancellationToken)

Deletes a draft by ID.

public Task<AtProtoHttpResult<EmptyResponse>> DeleteDraft(TimestampIdentifier draftId, CancellationToken cancellationToken = default)

Parameters

draftId TimestampIdentifier

The ID of the draft to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftId is null.

DeleteFollow(AtUri, CancellationToken)

Deletes the Bluesky follow record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky follow record, or its RecordKey is null.

DeleteFollow(StrongReference, CancellationToken)

Deletes the Bluesky follow record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteFollow(AtUri, CancellationToken)

Deletes the Bluesky follow record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky follow record, or its RecordKey is null.

DeleteFollow(StrongReference, CancellationToken)

Deletes the Bluesky follow record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteFollow(AtUri, CancellationToken)

Deletes the Bluesky follow record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky follow record, or its RecordKey is null.

DeleteFollow(StrongReference, CancellationToken)

Deletes the Bluesky follow record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFollow(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the follow record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteFromList(AtUri, CancellationToken)

Deletes the list entry referred to by the uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

To get a idunno.AtProto.AtUri for a particular subject in a list call idunno.Bluesky.BlueskyAgent.GetList(idunno.AtProto.AtUri,System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken), then, while paging through the results search the subject idunno.AtProto.Did or idunno.AtProto.Handle.

var listEntry = listEntriesResult.Result.FirstOrDefault(listEntry => listEntry.Subject.Handle == "blowdart.me")

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list item collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Did, CancellationToken)

Deletes the list entry referred to by the did from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches did.

did Did

The idunno.AtProto.Did of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when did, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Handle, CancellationToken)

Deletes the list entry referred to by the handle from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches handle.

handle Handle

The idunno.AtProto.Handle of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when handle, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, CancellationToken)

Deletes the list entry referred to by the uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

To get a idunno.AtProto.AtUri for a particular subject in a list call idunno.Bluesky.BlueskyAgent.GetList(idunno.AtProto.AtUri,System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken), then, while paging through the results search the subject idunno.AtProto.Did or idunno.AtProto.Handle.

var listEntry = listEntriesResult.Result.FirstOrDefault(listEntry => listEntry.Subject.Handle == "blowdart.me")

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list item collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Did, CancellationToken)

Deletes the list entry referred to by the did from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches did.

did Did

The idunno.AtProto.Did of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when did, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Handle, CancellationToken)

Deletes the list entry referred to by the handle from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches handle.

handle Handle

The idunno.AtProto.Handle of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when handle, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, CancellationToken)

Deletes the list entry referred to by the uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

To get a idunno.AtProto.AtUri for a particular subject in a list call idunno.Bluesky.BlueskyAgent.GetList(idunno.AtProto.AtUri,System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken), then, while paging through the results search the subject idunno.AtProto.Did or idunno.AtProto.Handle.

var listEntry = listEntriesResult.Result.FirstOrDefault(listEntry => listEntry.Subject.Handle == "blowdart.me")

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list item collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Did, CancellationToken)

Deletes the list entry referred to by the did from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Did did, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches did.

did Did

The idunno.AtProto.Did of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when did, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteFromList(AtUri, Handle, CancellationToken)

Deletes the list entry referred to by the handle from the list referred to by System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteFromList(AtUri uri, Handle handle, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete the subject whose idunno.AtProto.Did matches handle.

handle Handle

The idunno.AtProto.Handle of the subject to delete from the list

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

This method iterates through the list members search for the specified idunno.AtProto.Did. This may result in multiple API calls depending on the size of the list.

Exceptions

ArgumentNullException

Thrown when handle, uri or the uri collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to the list collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteLike(AtUri, CancellationToken)

Deletes the like record. If a post idunno.AtProto.AtUri is specified, it will delete the like of that post. If a like idunno.AtProto.AtUri is specified, it will delete that like record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the like of, or the direct idunno.AtProto.AtUri to a like record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post or like record, or its RecordKey is null.

BlueskyException

Thrown when the like record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteLike(StrongReference, CancellationToken)

Deletes the like record for the post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the like of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteLike(AtUri, CancellationToken)

Deletes the like record. If a post idunno.AtProto.AtUri is specified, it will delete the like of that post. If a like idunno.AtProto.AtUri is specified, it will delete that like record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the like of, or the direct idunno.AtProto.AtUri to a like record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post or like record, or its RecordKey is null.

BlueskyException

Thrown when the like record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteLike(StrongReference, CancellationToken)

Deletes the like record for the post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the like of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteLike(AtUri, CancellationToken)

Deletes the like record. If a post idunno.AtProto.AtUri is specified, it will delete the like of that post. If a like idunno.AtProto.AtUri is specified, it will delete that like record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the like of, or the direct idunno.AtProto.AtUri to a like record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post or like record, or its RecordKey is null.

BlueskyException

Thrown when the like record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteLike(StrongReference, CancellationToken)

Deletes the like record for the post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteLike(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the like of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteList(AtUri, CancellationToken)

Deletes the list referenced by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentException

Thrown if uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteList(AtUri, CancellationToken)

Deletes the list referenced by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentException

Thrown if uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteList(AtUri, CancellationToken)

Deletes the list referenced by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteList(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its collection property is null.

ArgumentException

Thrown if uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteMessageForSelf(string, string, CancellationToken)

Deletes the message specified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<DeletedMessageView>> DeleteMessageForSelf(string conversationId, string messageId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to delete the message identified by messageId from.

messageId string

The message identifier to delete from conversationId.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeletedMessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId or messageId is null or whitespace,

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteMessageForSelf(string, string, CancellationToken)

Deletes the message specified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<DeletedMessageView>> DeleteMessageForSelf(string conversationId, string messageId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to delete the message identified by messageId from.

messageId string

The message identifier to delete from conversationId.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeletedMessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId or messageId is null or whitespace,

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteMessageForSelf(string, string, CancellationToken)

Deletes the message specified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<DeletedMessageView>> DeleteMessageForSelf(string conversationId, string messageId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to delete the message identified by messageId from.

messageId string

The message identifier to delete from conversationId.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeletedMessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId or messageId is null or whitespace,

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeletePost(AtUri, CancellationToken)

Deletes the Bluesky post record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post record, or its RecordKey is null.

DeletePost(StrongReference, CancellationToken)

Deletes the Bluesky post record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeletePost(AtUri, CancellationToken)

Deletes the Bluesky post record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post record, or its RecordKey is null.

DeletePost(StrongReference, CancellationToken)

Deletes the Bluesky post record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeletePost(AtUri, CancellationToken)

Deletes the Bluesky post record specified by its System.Uri.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed post record, or its RecordKey is null.

DeletePost(StrongReference, CancellationToken)

Deletes the Bluesky post record specified by its idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeletePost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeletePostGate(AtUri, CancellationToken)

Deletes a post gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeletePostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the post gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DeletePostGate(AtUri, CancellationToken)

Deletes a post gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeletePostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the post gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DeletePostGate(AtUri, CancellationToken)

Deletes a post gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeletePostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the post gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DeleteQuote(AtUri, CancellationToken)

Deletes the Bluesky quote record specified by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteQuote(StrongReference, CancellationToken)

Deletes the Bluesky quote record specified by its strongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

A quote record is really a post record, so DeletePost() would also work. This method is just here for ease of discover and consistency.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteQuote(AtUri, CancellationToken)

Deletes the Bluesky quote record specified by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteQuote(StrongReference, CancellationToken)

Deletes the Bluesky quote record specified by its strongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

A quote record is really a post record, so DeletePost() would also work. This method is just here for ease of discover and consistency.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteQuote(AtUri, CancellationToken)

Deletes the Bluesky quote record specified by its uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteQuote(StrongReference, CancellationToken)

Deletes the Bluesky quote record specified by its strongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteQuote(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the quote to delete.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Remarks

A quote record is really a post record, so DeletePost() would also work. This method is just here for ease of discover and consistency.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteReferenceListOptOut(AtUri, CancellationToken)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when uri is not in the correct collection.

ArgumentNullException

Thrown when uri is null.

DeleteReferenceListOptOut(AtUri)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>, CancellationToken)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record, CancellationToken cancellationToken)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when record is not in the correct collection.

ArgumentNullException

Thrown when record is null.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteReferenceListOptOut(AtUri, CancellationToken)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when uri is not in the correct collection.

ArgumentNullException

Thrown when uri is null.

DeleteReferenceListOptOut(AtUri)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>, CancellationToken)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record, CancellationToken cancellationToken)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when record is not in the correct collection.

ArgumentNullException

Thrown when record is null.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteReferenceListOptOut(AtUri, CancellationToken)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when uri is not in the correct collection.

ArgumentNullException

Thrown when uri is null.

DeleteReferenceListOptOut(AtUri)

Deletes the reference list opt-out record specified by uri.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtUri uri)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>, CancellationToken)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record, CancellationToken cancellationToken)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when record is not in the correct collection.

ArgumentNullException

Thrown when record is null.

DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut>)

Deletes the reference list opt-out record specified by record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteReferenceListOptOut(AtProtoRepositoryRecord<ReferenceListOptOut> record)

Parameters

record AtProtoRepositoryRecord<ReferenceListOptOut>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 of the reference list opt-out record.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

DeleteRepost(AtUri, CancellationToken)

Deletes the repost record. If a post idunno.AtProto.AtUri is specified, it will delete the repost of that post. If a repost idunno.AtProto.AtUri is specified, it will delete that repost record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the repost of, or the direct idunno.AtProto.AtUri to a repost record..

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed repost record, or its RecordKey is null.

BlueskyException

Thrown when the repost record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteRepost(StrongReference, CancellationToken)

Deletes the repost record post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the repost of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteRepost(AtUri, CancellationToken)

Deletes the repost record. If a post idunno.AtProto.AtUri is specified, it will delete the repost of that post. If a repost idunno.AtProto.AtUri is specified, it will delete that repost record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the repost of, or the direct idunno.AtProto.AtUri to a repost record..

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed repost record, or its RecordKey is null.

BlueskyException

Thrown when the repost record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteRepost(StrongReference, CancellationToken)

Deletes the repost record post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the repost of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteRepost(AtUri, CancellationToken)

Deletes the repost record. If a post idunno.AtProto.AtUri is specified, it will delete the repost of that post. If a repost idunno.AtProto.AtUri is specified, it will delete that repost record.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(AtUri uri, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to delete the repost of, or the direct idunno.AtProto.AtUri to a repost record..

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

if uri is null.

AuthenticationRequiredException

if the agent is not authenticated.

ArgumentException

Thrown when the uri does not point to a Bluesky feed repost record, or its RecordKey is null.

BlueskyException

Thrown when the repost record discovery returns an invalid idunno.AtProto.AtUri with no record key.

DeleteRepost(StrongReference, CancellationToken)

Deletes the repost record post referenced by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<DeleteResult>> DeleteRepost(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to delete the repost of.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DeleteStatus(CancellationToken)

Deletes the profile status for the current authenticated user.

public Task<AtProtoHttpResult<DeleteResult>> DeleteStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteStatus(CancellationToken)

Deletes the profile status for the current authenticated user.

public Task<AtProtoHttpResult<DeleteResult>> DeleteStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteStatus(CancellationToken)

Deletes the profile status for the current authenticated user.

public Task<AtProtoHttpResult<DeleteResult>> DeleteStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

DeleteThreadGate(AtUri, CancellationToken)

Deletes a thread gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeleteThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the thread gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DeleteThreadGate(AtUri, CancellationToken)

Deletes a thread gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeleteThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the thread gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DeleteThreadGate(AtUri, CancellationToken)

Deletes a thread gate on the specified post, if one exists.

public Task<AtProtoHttpResult<DeleteResult>> DeleteThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The post to delete the thread gate from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

DisableJoinGroupLink(string, CancellationToken)

Disables the join link for a group.

public Task<AtProtoHttpResult<DisableJoinLinkResponse>> DisableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DisableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

DisableJoinGroupLink(string, CancellationToken)

Disables the join link for a group.

public Task<AtProtoHttpResult<DisableJoinLinkResponse>> DisableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DisableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

DisableJoinGroupLink(string, CancellationToken)

Disables the join link for a group.

public Task<AtProtoHttpResult<DisableJoinLinkResponse>> DisableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DisableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EditGroup(string, string, CancellationToken)

Edits the details of a group conversation.

public Task<AtProtoHttpResult<EditGroupResponse>> EditGroup(string conversationId, string name, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

name string

The new name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or name is null.

ArgumentException

Thrown when conversationId or name is empty.

ArgumentOutOfRangeException

Thrown when name exceeds the maximum allowed length.

EditGroup(string, string, CancellationToken)

Edits the details of a group conversation.

public Task<AtProtoHttpResult<EditGroupResponse>> EditGroup(string conversationId, string name, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

name string

The new name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or name is null.

ArgumentException

Thrown when conversationId or name is empty.

ArgumentOutOfRangeException

Thrown when name exceeds the maximum allowed length.

EditGroup(string, string, CancellationToken)

Edits the details of a group conversation.

public Task<AtProtoHttpResult<EditGroupResponse>> EditGroup(string conversationId, string name, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

name string

The new name of the group conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditGroupResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId or name is null.

ArgumentException

Thrown when conversationId or name is empty.

ArgumentOutOfRangeException

Thrown when name exceeds the maximum allowed length.

EditJoinGroupLink(string, bool?, string?, CancellationToken)

Edits the join link properties for a conversation

public Task<AtProtoHttpResult<EditJoinLinkResponse>> EditJoinGroupLink(string conversationId, bool? requireApproval = null, string? joinRule = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

requireApproval bool?

Flag indicating whether the conversation owner needs to approve joins.

joinRule string?

The join rule for the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EditJoinGroupLink(string, bool?, string?, CancellationToken)

Edits the join link properties for a conversation

public Task<AtProtoHttpResult<EditJoinLinkResponse>> EditJoinGroupLink(string conversationId, bool? requireApproval = null, string? joinRule = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

requireApproval bool?

Flag indicating whether the conversation owner needs to approve joins.

joinRule string?

The join rule for the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EditJoinGroupLink(string, bool?, string?, CancellationToken)

Edits the join link properties for a conversation

public Task<AtProtoHttpResult<EditJoinLinkResponse>> EditJoinGroupLink(string conversationId, bool? requireApproval = null, string? joinRule = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to edit.

requireApproval bool?

Flag indicating whether the conversation owner needs to approve joins.

joinRule string?

The join rule for the conversation. Known values are in idunno.Bluesky.Chat.Group.JoinRule

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EditJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EnableJoinGroupLink(string, CancellationToken)

Disables the join` link for a group.

public Task<AtProtoHttpResult<EnableJoinLinkResponse>> EnableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EnableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EnableJoinGroupLink(string, CancellationToken)

Disables the join` link for a group.

public Task<AtProtoHttpResult<EnableJoinLinkResponse>> EnableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EnableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

EnableJoinGroupLink(string, CancellationToken)

Disables the join` link for a group.

public Task<AtProtoHttpResult<EnableJoinLinkResponse>> EnableJoinGroupLink(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to disable the join link for

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EnableJoinLinkResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when conversationId is null.

FinishUpload(string, CancellationToken)

Finish an upload. This call is idempotent and safe to retry. On deduplication the returned completedJobId may differ from the jobId; Poll idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken) with idunno.Bluesky.Video.FinishUploadResponse.CompletedJobId. Probe-based validation failures surface later as idunno.Bluesky.Video.JobState.Failed from idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken), not as errors from this call.

public Task<AtProtoHttpResult<FinishUploadResponse>> FinishUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to finish.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FinishUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

FinishUpload(string, CancellationToken)

Finish an upload. This call is idempotent and safe to retry. On deduplication the returned completedJobId may differ from the jobId; Poll idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken) with idunno.Bluesky.Video.FinishUploadResponse.CompletedJobId. Probe-based validation failures surface later as idunno.Bluesky.Video.JobState.Failed from idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken), not as errors from this call.

public Task<AtProtoHttpResult<FinishUploadResponse>> FinishUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to finish.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FinishUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

FinishUpload(string, CancellationToken)

Finish an upload. This call is idempotent and safe to retry. On deduplication the returned completedJobId may differ from the jobId; Poll idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken) with idunno.Bluesky.Video.FinishUploadResponse.CompletedJobId. Probe-based validation failures surface later as idunno.Bluesky.Video.JobState.Failed from idunno.Bluesky.BlueskyAgent.GetJobStatus(System.String,System.Threading.CancellationToken), not as errors from this call.

public Task<AtProtoHttpResult<FinishUploadResponse>> FinishUpload(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to finish.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FinishUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

AuthenticationRequiredException

Thrown when agent is not authenticated.

Follow(Handle, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified handle.

public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Follow(Did, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Follow(Handle, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified handle.

public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Follow(Did, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Follow(Handle, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified handle.

public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Follow(Did, CancellationToken)

Creates a follow record in the authenticated user's repo for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Follow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to follow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetActorChatStatus(CancellationToken)

Gets the authenticated user's chat status.

public Task<AtProtoHttpResult<ChatStatus>> GetActorChatStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ChatStatus>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorChatStatus(CancellationToken)

Gets the authenticated user's chat status.

public Task<AtProtoHttpResult<ChatStatus>> GetActorChatStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ChatStatus>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorChatStatus(CancellationToken)

Gets the authenticated user's chat status.

public Task<AtProtoHttpResult<ChatStatus>> GetActorChatStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ChatStatus>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorFeeds(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paginated list of feeds (feed generator records) created by the actor, in the actor's repo.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetActorFeeds(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose feeds should be listed.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetActorFeeds(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paginated list of feeds (feed generator records) created by the actor, in the actor's repo.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetActorFeeds(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose feeds should be listed.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetActorFeeds(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paginated list of feeds (feed generator records) created by the actor, in the actor's repo.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetActorFeeds(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose feeds should be listed.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetActorLikes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of posts liked the current actor. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetActorLikes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorLikes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of posts liked the current actor. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetActorLikes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorLikes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of posts liked the current actor. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetActorLikes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetActorStarterPacks(AtIdentifier, int?, string?, CancellationToken)

Get a list of starter packs created by the actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> GetActorStarterPacks(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose starter packs should be returned.

limit int?

The maximum number of starter packs to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetActorStarterPacks(AtIdentifier, int?, string?, CancellationToken)

Get a list of starter packs created by the actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> GetActorStarterPacks(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose starter packs should be returned.

limit int?

The maximum number of starter packs to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetActorStarterPacks(AtIdentifier, int?, string?, CancellationToken)

Get a list of starter packs created by the actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> GetActorStarterPacks(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose starter packs should be returned.

limit int?

The maximum number of starter packs to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetAgeAssuranceState(CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetAgeAssuranceState(System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Gets the age assurance state for the current user.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<AgeAssuranceState>> GetAgeAssuranceState(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AgeAssuranceState>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetAgeAssuranceState(CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetAgeAssuranceState(System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Gets the age assurance state for the current user.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<AgeAssuranceState>> GetAgeAssuranceState(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AgeAssuranceState>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetAgeAssuranceState(CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetAgeAssuranceState(System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Gets the age assurance state for the current user.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<AgeAssuranceState>> GetAgeAssuranceState(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AgeAssuranceState>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetAuthorFeed(Did, int?, string?, FeedFilter?, bool?, IEnumerable<Did>?, CancellationToken)

Get a view of an actor's 'author feed' (post and reposts by the author).

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetAuthorFeed(Did actor, int? limit = null, string? cursor = null, FeedFilter? filter = FeedFilter.PostsNoReplies, bool? includePins = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor Did

The idunno.AtProto.Did of the actor whose feed should be retrieved.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

filter FeedFilter?

Combinations of post/repost types to include in the results.

includePins bool?

Flag indicating whether to include pinned posts in the results.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetAuthorFeed(Did, int?, string?, FeedFilter?, bool?, IEnumerable<Did>?, CancellationToken)

Get a view of an actor's 'author feed' (post and reposts by the author).

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetAuthorFeed(Did actor, int? limit = null, string? cursor = null, FeedFilter? filter = FeedFilter.PostsNoReplies, bool? includePins = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor Did

The idunno.AtProto.Did of the actor whose feed should be retrieved.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

filter FeedFilter?

Combinations of post/repost types to include in the results.

includePins bool?

Flag indicating whether to include pinned posts in the results.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetAuthorFeed(Did, int?, string?, FeedFilter?, bool?, IEnumerable<Did>?, CancellationToken)

Get a view of an actor's 'author feed' (post and reposts by the author).

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetAuthorFeed(Did actor, int? limit = null, string? cursor = null, FeedFilter? filter = FeedFilter.PostsNoReplies, bool? includePins = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor Did

The idunno.AtProto.Did of the actor whose feed should be retrieved.

limit int?

The maximum number of feeds to return from the api.

cursor string?

An optional cursor for pagination.

filter FeedFilter?

Combinations of post/repost types to include in the results.

includePins bool?

Flag indicating whether to include pinned posts in the results.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Enumerates which accounts the requesting account is currently blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Enumerates which accounts the requesting account is currently blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Enumerates which accounts the requesting account is currently blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetBlueskyRecord<TRecord>(AtIdentifier, Nsid, RecordKey, Cid?, string?, CancellationToken)

Gets the Bluesky record specified by the identifying parameters.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtIdentifier repo, Nsid collection, RecordKey rKey, Cid? cid = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the record from.

collection Nsid

The NSID of the collection the record should be retrieved from.

rKey RecordKey

The record key, identifying the record to be retrieved.

cid Cid?

The CID of the version of the record. If not specified, then return the most recent version.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when repo, collection is null or empty.

GetBlueskyRecord<TRecord>(AtUri, string?, CancellationToken)

Gets the Bluesky record specified by the uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtUri uri, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to retrieve.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when uri, or its collection or rkey property is null.

GetBlueskyRecord<TRecord>(AtIdentifier, Nsid, RecordKey, Cid?, string?, CancellationToken)

Gets the Bluesky record specified by the identifying parameters.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtIdentifier repo, Nsid collection, RecordKey rKey, Cid? cid = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the record from.

collection Nsid

The NSID of the collection the record should be retrieved from.

rKey RecordKey

The record key, identifying the record to be retrieved.

cid Cid?

The CID of the version of the record. If not specified, then return the most recent version.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when repo, collection is null or empty.

GetBlueskyRecord<TRecord>(AtUri, string?, CancellationToken)

Gets the Bluesky record specified by the uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtUri uri, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to retrieve.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when uri, or its collection or rkey property is null.

GetBlueskyRecord<TRecord>(AtIdentifier, Nsid, RecordKey, Cid?, string?, CancellationToken)

Gets the Bluesky record specified by the identifying parameters.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtIdentifier repo, Nsid collection, RecordKey rKey, Cid? cid = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the record from.

collection Nsid

The NSID of the collection the record should be retrieved from.

rKey RecordKey

The record key, identifying the record to be retrieved.

cid Cid?

The CID of the version of the record. If not specified, then return the most recent version.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when repo, collection is null or empty.

GetBlueskyRecord<TRecord>(AtUri, string?, CancellationToken)

Gets the Bluesky record specified by the uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>> GetBlueskyRecord<TRecord>(AtUri uri, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

uri AtUri

The idunno.AtProto.AtUri of the record to retrieve.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<TRecord>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of record to get.

Exceptions

ArgumentNullException

Thrown when uri, or its collection or rkey property is null.

GetBookmarks(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a pageable list of the specified user's bookmarks. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>> GetBookmarks(int? limit, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of bookmarks to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the bookmarked items.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>>

The task object representing the asynchronous operation.

Remarks

If limit is null the number of bookmarks returned is left to the service to decide.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than idunno.Bluesky.Maximum.Bookmarks.

GetBookmarks(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a pageable list of the specified user's bookmarks. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>> GetBookmarks(int? limit, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of bookmarks to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the bookmarked items.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>>

The task object representing the asynchronous operation.

Remarks

If limit is null the number of bookmarks returned is left to the service to decide.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than idunno.Bluesky.Maximum.Bookmarks.

GetBookmarks(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a pageable list of the specified user's bookmarks. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>> GetBookmarks(int? limit, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of bookmarks to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the bookmarked items.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<BookmarkView>>>

The task object representing the asynchronous operation.

Remarks

If limit is null the number of bookmarks returned is left to the service to decide.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than idunno.Bluesky.Maximum.Bookmarks.

GetChatNotificationPreferences(CancellationToken)

Gets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> GetChatNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetChatNotificationPreferences(CancellationToken)

Gets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> GetChatNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetChatNotificationPreferences(CancellationToken)

Gets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> GetChatNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetContentVisibilityDeclaration(AtIdentifier, CancellationToken)

Gets an actor's preference for appearing in content discovery surfaces. Missing records must be treated as false.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(AtIdentifier identifier, CancellationToken cancellationToken = default)

Parameters

identifier AtIdentifier

The identifier of the actor whose preference should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

HandleResolutionException

Thrown when identifier is a handle which cannot be resolved to a idunno.AtProto.Did.

GetContentVisibilityDeclaration()

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration()

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetContentVisibilityDeclaration(CancellationToken)

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetContentVisibilityDeclaration(AtIdentifier, CancellationToken)

Gets an actor's preference for appearing in content discovery surfaces. Missing records must be treated as false.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(AtIdentifier identifier, CancellationToken cancellationToken = default)

Parameters

identifier AtIdentifier

The identifier of the actor whose preference should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

HandleResolutionException

Thrown when identifier is a handle which cannot be resolved to a idunno.AtProto.Did.

GetContentVisibilityDeclaration()

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration()

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetContentVisibilityDeclaration(CancellationToken)

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetContentVisibilityDeclaration(AtIdentifier, CancellationToken)

Gets an actor's preference for appearing in content discovery surfaces. Missing records must be treated as false.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to CreateRecord().")]
public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(AtIdentifier identifier, CancellationToken cancellationToken = default)

Parameters

identifier AtIdentifier

The identifier of the actor whose preference should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

HandleResolutionException

Thrown when identifier is a handle which cannot be resolved to a idunno.AtProto.Did.

GetContentVisibilityDeclaration()

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration()

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetContentVisibilityDeclaration(CancellationToken)

Gets the current authenticated user's preference for appearing in content discovery surfaces.

public Task<AtProtoHttpResult<ContentVisibilityDeclaration>> GetContentVisibilityDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ContentVisibilityDeclaration>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetConversation(string, CancellationToken)

Gets a view over conversation by its id.

public Task<AtProtoHttpResult<ConversationView>> GetConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when idis null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversation(string, CancellationToken)

Gets a view over conversation by its id.

public Task<AtProtoHttpResult<ConversationView>> GetConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when idis null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversation(string, CancellationToken)

Gets a view over conversation by its id.

public Task<AtProtoHttpResult<ConversationView>> GetConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when idis null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationAvailability(Did)

Gets the availability of a conversation between the authenticated user, and the user identified by member. If an existing conversation is found for these members, it is returned.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(Did, CancellationToken)

Check whether the requester and member can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for the member, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member, CancellationToken cancellationToken)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(ICollection<Did>)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationAvailability(ICollection<Did>, CancellationToken)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members, CancellationToken cancellationToken)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationAvailability(Did)

Gets the availability of a conversation between the authenticated user, and the user identified by member. If an existing conversation is found for these members, it is returned.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(Did, CancellationToken)

Check whether the requester and member can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for the member, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member, CancellationToken cancellationToken)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(ICollection<Did>)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationAvailability(ICollection<Did>, CancellationToken)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members, CancellationToken cancellationToken)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationAvailability(Did)

Gets the availability of a conversation between the authenticated user, and the user identified by member. If an existing conversation is found for these members, it is returned.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(Did, CancellationToken)

Check whether the requester and member can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for the member, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(Did member, CancellationToken cancellationToken)

Parameters

member Did

The idunno.AtProto.Did of the actor to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when member is null.

GetConversationAvailability(ICollection<Did>)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationAvailability(ICollection<Did>, CancellationToken)

Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing conversation is found for these members, it is returned. Does not create a new conversation if it doesn't exist.

public Task<AtProtoHttpResult<ConversationAvailability>> GetConversationAvailability(ICollection<Did> members, CancellationToken cancellationToken)

Parameters

members ICollection<Did>

A collection of idunno.AtProto.Did of actors to check availability for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationAvailability>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or contains more than the maximum allowed members.

GetConversationDeclaration()

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(CancellationToken)

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(Did, CancellationToken)

Gets the conversation declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose conversation record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetConversationDeclaration()

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(CancellationToken)

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(Did, CancellationToken)

Gets the conversation declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose conversation record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetConversationDeclaration()

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(CancellationToken)

Gets the conversation declaration record for authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationDeclaration(Did, CancellationToken)

Gets the conversation declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetConversationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose conversation record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetConversationForMembers(ICollection<Did>, CancellationToken)

Get or create a 1-1 conversation for the given members. Always returns the same direct (non-group) conversation. To create a group conversation, use idunno.Bluesky.BlueskyAgent.CreateGroup(System.Collections.Generic.ICollection{idunno.AtProto.Did},System.String,System.Threading.CancellationToken).

public Task<AtProtoHttpResult<ConversationView>> GetConversationForMembers(ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The idunno.AtProto.Dids of the conversation members.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or has greater than the maximum number of conversation members.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationForMembers(ICollection<Did>, CancellationToken)

Get or create a 1-1 conversation for the given members. Always returns the same direct (non-group) conversation. To create a group conversation, use idunno.Bluesky.BlueskyAgent.CreateGroup(System.Collections.Generic.ICollection{idunno.AtProto.Did},System.String,System.Threading.CancellationToken).

public Task<AtProtoHttpResult<ConversationView>> GetConversationForMembers(ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The idunno.AtProto.Dids of the conversation members.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or has greater than the maximum number of conversation members.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationForMembers(ICollection<Did>, CancellationToken)

Get or create a 1-1 conversation for the given members. Always returns the same direct (non-group) conversation. To create a group conversation, use idunno.Bluesky.BlueskyAgent.CreateGroup(System.Collections.Generic.ICollection{idunno.AtProto.Did},System.String,System.Threading.CancellationToken).

public Task<AtProtoHttpResult<ConversationView>> GetConversationForMembers(ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

members ICollection<Did>

The idunno.AtProto.Dids of the conversation members.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when members is null.

ArgumentOutOfRangeException

Thrown when members is empty or has greater than the maximum number of conversation members.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationLog(string?, CancellationToken)

Enumerates the conversation log.

public Task<AtProtoHttpResult<Logs>> GetConversationLog(string? cursor = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

A cursor to retrieve logs from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Logs>>

The task object representing the asynchronous operation.

Remarks

The getLogs endpoint has a different semantic to most other Bluesky API endpoints, it starts from "now". The intended use case is to use it to apply changes on top of some current state that you already have. To retrieve logs for the current user from the beginning of time use the zero-cursor, "2222222222222".

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationLog(string?, CancellationToken)

Enumerates the conversation log.

public Task<AtProtoHttpResult<Logs>> GetConversationLog(string? cursor = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

A cursor to retrieve logs from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Logs>>

The task object representing the asynchronous operation.

Remarks

The getLogs endpoint has a different semantic to most other Bluesky API endpoints, it starts from "now". The intended use case is to use it to apply changes on top of some current state that you already have. To retrieve logs for the current user from the beginning of time use the zero-cursor, "2222222222222".

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationLog(string?, CancellationToken)

Enumerates the conversation log.

public Task<AtProtoHttpResult<Logs>> GetConversationLog(string? cursor = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

A cursor to retrieve logs from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Logs>>

The task object representing the asynchronous operation.

Remarks

The getLogs endpoint has a different semantic to most other Bluesky API endpoints, it starts from "now". The intended use case is to use it to apply changes on top of some current state that you already have. To retrieve logs for the current user from the beginning of time use the zero-cursor, "2222222222222".

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationMembers(string, int?, string?, CancellationToken)

Gets a idunno.Bluesky.PagedViewReadOnlyCollection`1 representing the members of a conversation.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> GetConversationMembers(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The identifier of the conversation.

limit int?

An optional limit on the number of members to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationMembers(string, int?, string?, CancellationToken)

Gets a idunno.Bluesky.PagedViewReadOnlyCollection`1 representing the members of a conversation.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> GetConversationMembers(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The identifier of the conversation.

limit int?

An optional limit on the number of members to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetConversationMembers(string, int?, string?, CancellationToken)

Gets a idunno.Bluesky.PagedViewReadOnlyCollection`1 representing the members of a conversation.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> GetConversationMembers(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The identifier of the conversation.

limit int?

An optional limit on the number of members to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetDrafts(int?, string?, CancellationToken)

Get a paged list of suggested drafts for the authenticated user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>> GetDrafts(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of drafts to return.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is negative, zero, or greater than idunno.Bluesky.Maximum.ListedDrafts.

GetDrafts(int?, string?, CancellationToken)

Get a paged list of suggested drafts for the authenticated user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>> GetDrafts(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of drafts to return.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is negative, zero, or greater than idunno.Bluesky.Maximum.ListedDrafts.

GetDrafts(int?, string?, CancellationToken)

Get a paged list of suggested drafts for the authenticated user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>> GetDrafts(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of drafts to return.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<DraftView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is negative, zero, or greater than idunno.Bluesky.Maximum.ListedDrafts.

GetEmbedExternalView(Uri, AtUri[], IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(Uri url, AtUri[] uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

url Uri

The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's uri. May be used for validation in the future.

uris AtUri[]

An array of AT-URIs to resolve into the data needed for the embed.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested url. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a required argument is null.

GetEmbedExternalView(PostView)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(Uri, AtUri[], IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(Uri url, AtUri[] uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

url Uri

The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's uri. May be used for validation in the future.

uris AtUri[]

An array of AT-URIs to resolve into the data needed for the embed.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested url. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a required argument is null.

GetEmbedExternalView(PostView)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(Uri, AtUri[], IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(Uri url, AtUri[] uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

url Uri

The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's uri. May be used for validation in the future.

uris AtUri[]

An array of AT-URIs to resolve into the data needed for the embed.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested url. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a required argument is null.

GetEmbedExternalView(PostView)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetEmbedExternalView(PostView, IEnumerable<Did>?, CancellationToken)

Resolve one or more idunno.AtProto.AtUris into the data needed to render an enhanced external embed.

public Task<AtProtoHttpResult<EmbeddedExternalView>> GetEmbedExternalView(PostView postView, IEnumerable<Did>? subscribedLabelers, CancellationToken cancellationToken)

Parameters

postView PostView

The idunno.Bluesky.Feed.PostView containing the external embed to resolve.

subscribedLabelers IEnumerable<Did>?

Optional list of subscribed labelers.

cancellationToken CancellationToken

Optional cancellation token.

Returns

Task<AtProtoHttpResult<EmbeddedExternalView>>

The task object representing the asynchronous operation.

Remarks

Only the hydrated view is returned. The raw associated records the service returns are not surfaced.

The service returns an empty response when no records were resolvable, or when validation determined the resolved records do not actually back the requested link. That case is reported as an unsuccessful result whose idunno.AtProto.AtProtoHttpResult`1.StatusCode is System.Net.HttpStatusCode.NoContent and whose idunno.AtProto.AtProtoHttpResult`1.AtErrorDetail is null. Callers should fall back to their own link card rendering in that case and skip writing strong references to the post.

Exceptions

ArgumentNullException

Thrown when a postView or its Embed property is null.

ArgumentException

Thrown when the postView does not contain an idunno.Bluesky.Embed.EmbeddedExternalView.

GetFeed(AtUri, int?, string?, ICollection<NameValueHeaderValue>?, IEnumerable<Did>?, CancellationToken)

Get a hydrated feed from an actor's selected feed generator.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetFeed(AtUri feed, int? limit = null, string? cursor = null, ICollection<NameValueHeaderValue>? headers = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtIdentifier of the feed to be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

headers ICollection<NameValueHeaderValue>?

A collection of HTTP headers to send with the request.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeed(AtUri, int?, string?, ICollection<NameValueHeaderValue>?, IEnumerable<Did>?, CancellationToken)

Get a hydrated feed from an actor's selected feed generator.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetFeed(AtUri feed, int? limit = null, string? cursor = null, ICollection<NameValueHeaderValue>? headers = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtIdentifier of the feed to be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

headers ICollection<NameValueHeaderValue>?

A collection of HTTP headers to send with the request.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeed(AtUri, int?, string?, ICollection<NameValueHeaderValue>?, IEnumerable<Did>?, CancellationToken)

Get a hydrated feed from an actor's selected feed generator.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetFeed(AtUri feed, int? limit = null, string? cursor = null, ICollection<NameValueHeaderValue>? headers = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtIdentifier of the feed to be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

headers ICollection<NameValueHeaderValue>?

A collection of HTTP headers to send with the request.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeedGenerator(AtUri, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generator.

public Task<AtProtoHttpResult<FeedGenerator>> GetFeedGenerator(AtUri feed, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtUri of the feed generator whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGenerator>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeedGenerator(AtUri, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generator.

public Task<AtProtoHttpResult<FeedGenerator>> GetFeedGenerator(AtUri feed, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtUri of the feed generator whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGenerator>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeedGenerator(AtUri, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generator.

public Task<AtProtoHttpResult<FeedGenerator>> GetFeedGenerator(AtUri feed, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feed AtUri

The idunno.AtProto.AtUri of the feed generator whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGenerator>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feed is null.

GetFeedGeneratorDescription(Uri, CancellationToken)

Gets a description for the feed generator at generatorUri.

public Task<AtProtoHttpResult<FeedGeneratorDescription>> GetFeedGeneratorDescription(Uri generatorUri, CancellationToken cancellationToken = default)

Parameters

generatorUri Uri

The System.Uri of the generator whose description should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGeneratorDescription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when generatorUri is null.

GetFeedGeneratorDescription(Uri, CancellationToken)

Gets a description for the feed generator at generatorUri.

public Task<AtProtoHttpResult<FeedGeneratorDescription>> GetFeedGeneratorDescription(Uri generatorUri, CancellationToken cancellationToken = default)

Parameters

generatorUri Uri

The System.Uri of the generator whose description should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGeneratorDescription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when generatorUri is null.

GetFeedGeneratorDescription(Uri, CancellationToken)

Gets a description for the feed generator at generatorUri.

public Task<AtProtoHttpResult<FeedGeneratorDescription>> GetFeedGeneratorDescription(Uri generatorUri, CancellationToken cancellationToken = default)

Parameters

generatorUri Uri

The System.Uri of the generator whose description should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<FeedGeneratorDescription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when generatorUri is null.

GetFeedGenerators(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generators.

public Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>> GetFeedGenerators(IEnumerable<AtUri> feeds, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feeds IEnumerable<AtUri>

The idunno.AtProto.AtUri of the feed generators whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feeds is null.

ArgumentOutOfRangeException

Thrown when feeds is empty.

GetFeedGenerators(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generators.

public Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>> GetFeedGenerators(IEnumerable<AtUri> feeds, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feeds IEnumerable<AtUri>

The idunno.AtProto.AtUri of the feed generators whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feeds is null.

ArgumentOutOfRangeException

Thrown when feeds is empty.

GetFeedGenerators(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets information about the specified feed generators.

public Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>> GetFeedGenerators(IEnumerable<AtUri> feeds, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

feeds IEnumerable<AtUri>

The idunno.AtProto.AtUri of the feed generators whose information should be retrieved.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when feeds is null.

ArgumentOutOfRangeException

Thrown when feeds is empty.

GetFollowers(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the specified actor.

public Task<AtProtoHttpResult<Followers>> GetFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose followers should be retrieved.

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollowers(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the current user. Requires an authenticated session.

public Task<AtProtoHttpResult<Followers>> GetFollowers(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetFollowers(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the specified actor.

public Task<AtProtoHttpResult<Followers>> GetFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose followers should be retrieved.

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollowers(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the current user. Requires an authenticated session.

public Task<AtProtoHttpResult<Followers>> GetFollowers(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetFollowers(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the specified actor.

public Task<AtProtoHttpResult<Followers>> GetFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose followers should be retrieved.

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollowers(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of followers for the current user. Requires an authenticated session.

public Task<AtProtoHttpResult<Followers>> GetFollowers(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of followers that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetFollows(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom an actor follows.

public Task<AtProtoHttpResult<Follows>> GetFollows(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be retrieved.

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollows(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom the current user follows. Requires an authenticated session.

public Task<AtProtoHttpResult<Follows>> GetFollows(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetFollows(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom an actor follows.

public Task<AtProtoHttpResult<Follows>> GetFollows(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be retrieved.

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollows(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom the current user follows. Requires an authenticated session.

public Task<AtProtoHttpResult<Follows>> GetFollows(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetFollows(AtIdentifier, int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom an actor follows.

public Task<AtProtoHttpResult<Follows>> GetFollows(AtIdentifier actor, int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be retrieved.

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetFollows(int?, string?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts whom the current user follows. Requires an authenticated session.

public Task<AtProtoHttpResult<Follows>> GetFollows(int? limit = null, string? cursor = null, string? sort = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of follows that will be included in the paged results.

cursor string?

An optional cursor for pagination.

sort string?

An optional sort order for the results. Known values are "latest" and "top".

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Follows>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetJobStatus(string, CancellationToken)

Gets the status details for the specified single part video processing job.

public Task<AtProtoHttpResult<JobStatus>> GetJobStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetJobStatus(string, CancellationToken)

Gets the status details for the specified single part video processing job.

public Task<AtProtoHttpResult<JobStatus>> GetJobStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetJobStatus(string, CancellationToken)

Gets the status details for the specified single part video processing job.

public Task<AtProtoHttpResult<JobStatus>> GetJobStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetJoinGroupLinkPreviews(ICollection<string>, CancellationToken)

Get public information about groups from join links. The output array matches the input codes one-to-one by position (and each view also carries its 'code'). Disabled codes return a disabledJoinLinkPreviewView, and codes that do not map to a previewable link return an invalidJoinLinkPreviewView.

public Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>> GetJoinGroupLinkPreviews(ICollection<string> codes, CancellationToken cancellationToken = default)

Parameters

codes ICollection<string>

The codes of the group conversations to get join link previews for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when codes is null.

ArgumentException

Thrown when codes is empty or contains a null or empty code.

ArgumentOutOfRangeException

Thrown when codes contains more than idunno.Bluesky.Maximum.JoinLinkPreviewCodes items.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetJoinGroupLinkPreviews(ICollection<string>, CancellationToken)

Get public information about groups from join links. The output array matches the input codes one-to-one by position (and each view also carries its 'code'). Disabled codes return a disabledJoinLinkPreviewView, and codes that do not map to a previewable link return an invalidJoinLinkPreviewView.

public Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>> GetJoinGroupLinkPreviews(ICollection<string> codes, CancellationToken cancellationToken = default)

Parameters

codes ICollection<string>

The codes of the group conversations to get join link previews for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when codes is null.

ArgumentException

Thrown when codes is empty or contains a null or empty code.

ArgumentOutOfRangeException

Thrown when codes contains more than idunno.Bluesky.Maximum.JoinLinkPreviewCodes items.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetJoinGroupLinkPreviews(ICollection<string>, CancellationToken)

Get public information about groups from join links. The output array matches the input codes one-to-one by position (and each view also carries its 'code'). Disabled codes return a disabledJoinLinkPreviewView, and codes that do not map to a previewable link return an invalidJoinLinkPreviewView.

public Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>> GetJoinGroupLinkPreviews(ICollection<string> codes, CancellationToken cancellationToken = default)

Parameters

codes ICollection<string>

The codes of the group conversations to get join link previews for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<GetJoinLinkPreviewsResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when codes is null.

ArgumentException

Thrown when codes is empty or contains a null or empty code.

ArgumentOutOfRangeException

Thrown when codes contains more than idunno.Bluesky.Maximum.JoinLinkPreviewCodes items.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetKnownFollowers(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts which follow a specified account (actor) and are followed by the viewer. Requires authentication.

public Task<AtProtoHttpResult<Followers>> GetKnownFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetKnownFollowers(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts which follow a specified account (actor) and are followed by the viewer. Requires authentication.

public Task<AtProtoHttpResult<Followers>> GetKnownFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetKnownFollowers(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Gets a paged list of accounts which follow a specified account (actor) and are followed by the viewer. Requires authentication.

public Task<AtProtoHttpResult<Followers>> GetKnownFollowers(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of followers that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Followers>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetLabelerDeclaration(Did, CancellationToken)

Gets the labeler declaration record value for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did, CancellationToken cancellationToken)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetLabelerDeclaration(Did)

Gets the labeler declaration record value for the specified did.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(Handle, CancellationToken)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle, CancellationToken cancellationToken)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

GetLabelerDeclaration(Handle)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(AtIdentifier, CancellationToken)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier, CancellationToken cancellationToken)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

ArgumentException

Thrown when identifier cannot be converted to a idunno.AtProto.Did or idunno.AtProto.Handle.

GetLabelerDeclaration(AtIdentifier)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(Did, CancellationToken)

Gets the labeler declaration record value for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did, CancellationToken cancellationToken)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetLabelerDeclaration(Did)

Gets the labeler declaration record value for the specified did.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(Handle, CancellationToken)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle, CancellationToken cancellationToken)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

GetLabelerDeclaration(Handle)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(AtIdentifier, CancellationToken)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier, CancellationToken cancellationToken)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

ArgumentException

Thrown when identifier cannot be converted to a idunno.AtProto.Did or idunno.AtProto.Handle.

GetLabelerDeclaration(AtIdentifier)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(Did, CancellationToken)

Gets the labeler declaration record value for the specified did.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did, CancellationToken cancellationToken)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetLabelerDeclaration(Did)

Gets the labeler declaration record value for the specified did.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Did did)

Parameters

did Did

The labeler idunno.AtProto.Did whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(Handle, CancellationToken)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle, CancellationToken cancellationToken)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

GetLabelerDeclaration(Handle)

Gets the labeler declaration record value for the specified handle.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(Handle handle)

Parameters

handle Handle

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerDeclaration(AtIdentifier, CancellationToken)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier, CancellationToken cancellationToken)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when identifier is null.

ArgumentException

Thrown when identifier cannot be converted to a idunno.AtProto.Did or idunno.AtProto.Handle.

GetLabelerDeclaration(AtIdentifier)

Gets the labeler declaration record value for the specified identifier.

public Task<AtProtoHttpResult<Service>> GetLabelerDeclaration(AtIdentifier identifier)

Parameters

identifier AtIdentifier

The labeler idunno.AtProto.Handle whose declaration record should be returned.

Returns

Task<AtProtoHttpResult<Service>>

The task object representing the asynchronous operation.

GetLabelerServices(bool, CancellationToken)

Gets information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLabelerServices(IEnumerable<Did>, bool, CancellationToken)

Gets information about the labeler services identified by the specified dids.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(IEnumerable<Did> dids, bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

dids IEnumerable<Did>

A collection of idunno.AtProto.Dids for the labelers whose service views should be returned

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when dids is null.

ArgumentOutOfRangeException

Thrown when dids is empty.

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLabelerServices(bool, CancellationToken)

Gets information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLabelerServices(IEnumerable<Did>, bool, CancellationToken)

Gets information about the labeler services identified by the specified dids.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(IEnumerable<Did> dids, bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

dids IEnumerable<Did>

A collection of idunno.AtProto.Dids for the labelers whose service views should be returned

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when dids is null.

ArgumentOutOfRangeException

Thrown when dids is empty.

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLabelerServices(bool, CancellationToken)

Gets information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLabelerServices(IEnumerable<Did>, bool, CancellationToken)

Gets information about the labeler services identified by the specified dids.

public Task<AtProtoHttpResult<ICollection<LabelerView>>> GetLabelerServices(IEnumerable<Did> dids, bool getDetailedViews = false, CancellationToken cancellationToken = default)

Parameters

dids IEnumerable<Did>

A collection of idunno.AtProto.Dids for the labelers whose service views should be returned

getDetailedViews bool

Flag indicating whether a detailed view for each service should be returned.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when dids is null.

ArgumentOutOfRangeException

Thrown when dids is empty.

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetLikes(AtUri, Cid?, int?, string?, CancellationToken)

Get like records which reference a subject, by uri and, optionally, cid.

public Task<AtProtoHttpResult<LikesCollection>> GetLikes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the subject whose likes should be retrieved.

cid Cid?

The idunno.AtProto.Cid of the subject whose likes should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<LikesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetLikes(AtUri, Cid?, int?, string?, CancellationToken)

Get like records which reference a subject, by uri and, optionally, cid.

public Task<AtProtoHttpResult<LikesCollection>> GetLikes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the subject whose likes should be retrieved.

cid Cid?

The idunno.AtProto.Cid of the subject whose likes should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<LikesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetLikes(AtUri, Cid?, int?, string?, CancellationToken)

Get like records which reference a subject, by uri and, optionally, cid.

public Task<AtProtoHttpResult<LikesCollection>> GetLikes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the subject whose likes should be retrieved.

cid Cid?

The idunno.AtProto.Cid of the subject whose likes should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<LikesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetList(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a idunno.Bluesky.Graph.ListView of a Bluesky list and a paginated collection of idunno.Bluesky.Graph.ListItemViews of its items.

public Task<AtProtoHttpResult<ListViewWithItems>> GetList(AtUri uri, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to get.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ListViewWithItems>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetList(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a idunno.Bluesky.Graph.ListView of a Bluesky list and a paginated collection of idunno.Bluesky.Graph.ListItemViews of its items.

public Task<AtProtoHttpResult<ListViewWithItems>> GetList(AtUri uri, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to get.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ListViewWithItems>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetList(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a idunno.Bluesky.Graph.ListView of a Bluesky list and a paginated collection of idunno.Bluesky.Graph.ListItemViews of its items.

public Task<AtProtoHttpResult<ListViewWithItems>> GetList(AtUri uri, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list to get.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ListViewWithItems>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetListBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListBlocks(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is blocking. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListBlocks(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListFeed(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a feed of recent posts from a list (posts and reposts from any actors on the list)

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetListFeed(AtUri list, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

list AtUri

The idunno.AtProto.AtIdentifier of the list whose posts should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

GetListFeed(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a feed of recent posts from a list (posts and reposts from any actors on the list)

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetListFeed(AtUri list, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

list AtUri

The idunno.AtProto.AtIdentifier of the list whose posts should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

GetListFeed(AtUri, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a feed of recent posts from a list (posts and reposts from any actors on the list)

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>> GetListFeed(AtUri list, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

list AtUri

The idunno.AtProto.AtIdentifier of the list whose posts should be retrieved.

limit int?

The maximum number of items to return from the api.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<FeedViewPost>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list is null.

GetListMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is muting. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is muting. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of mod lists that the requesting account (actor) is muting. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetListMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetListRecord(AtUri, CancellationToken)

Gets the referenced record for a list.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>> GetListRecord(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to get.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null or the idunno.AtProto.AtUri.Collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list record.

GetListRecord(AtUri, CancellationToken)

Gets the referenced record for a list.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>> GetListRecord(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to get.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null or the idunno.AtProto.AtUri.Collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list record.

GetListRecord(AtUri, CancellationToken)

Gets the referenced record for a list.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>> GetListRecord(AtUri uri, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to get.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<List>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null or the idunno.AtProto.AtUri.Collection property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list record.

GetLists(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of lists that created by the specified actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetLists(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor whose lists to enumerate.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetLists(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of lists that created by the specified actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetLists(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor whose lists to enumerate.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetLists(AtIdentifier, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of lists that created by the specified actor.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>> GetLists(AtIdentifier actor, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor whose lists to enumerate.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetListsWithMembership(AtIdentifier, int?, string?, string[]?, IEnumerable<Did>?, CancellationToken)

Enumerates the lists created by the session user, and includes membership information about actor in those lists. Only supports curation and moderation lists (no reference lists, used in starter packs). Requires auth.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>> GetListsWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, string[]? purposes = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account (actor) to check for membership.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

purposes string[]?

Optional filter by list purpose. If not specified, all supported types are returned. Possible values: [modlist, curatelist]

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when actor is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetListsWithMembership(AtIdentifier, int?, string?, string[]?, IEnumerable<Did>?, CancellationToken)

Enumerates the lists created by the session user, and includes membership information about actor in those lists. Only supports curation and moderation lists (no reference lists, used in starter packs). Requires auth.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>> GetListsWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, string[]? purposes = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account (actor) to check for membership.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

purposes string[]?

Optional filter by list purpose. If not specified, all supported types are returned. Possible values: [modlist, curatelist]

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when actor is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetListsWithMembership(AtIdentifier, int?, string?, string[]?, IEnumerable<Did>?, CancellationToken)

Enumerates the lists created by the session user, and includes membership information about actor in those lists. Only supports curation and moderation lists (no reference lists, used in starter packs). Requires auth.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>> GetListsWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, string[]? purposes = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account (actor) to check for membership.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

purposes string[]?

Optional filter by list purpose. If not specified, all supported types are returned. Possible values: [modlist, curatelist]

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ListWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when actor is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

ArgumentOutOfRangeException

Thrown when limit is < 1 or > 100.

GetMessages(string, int?, string?, CancellationToken)

Enumerates the messages in a conversation.

public Task<AtProtoHttpResult<Messages>> GetMessages(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier whose messages should be retrieved.

limit int?

An optional limit on the number of messages to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Messages>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetMessages(string, int?, string?, CancellationToken)

Enumerates the messages in a conversation.

public Task<AtProtoHttpResult<Messages>> GetMessages(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier whose messages should be retrieved.

limit int?

An optional limit on the number of messages to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Messages>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetMessages(string, int?, string?, CancellationToken)

Enumerates the messages in a conversation.

public Task<AtProtoHttpResult<Messages>> GetMessages(string id, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier whose messages should be retrieved.

limit int?

An optional limit on the number of messages to retrieve in each page.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Messages>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of accounts that the requesting account currently has fully muted. Mutes scoped to specific kinds of content (only reposts, only quote posts) are not included. Responses may contain more items than the requested limit. Requires authentication

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of accounts that the requesting account currently has fully muted. Mutes scoped to specific kinds of content (only reposts, only quote posts) are not included. Responses may contain more items than the requested limit. Requires authentication

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetMutes(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a paged list of accounts that the requesting account currently has fully muted. Mutes scoped to specific kinds of content (only reposts, only quote posts) are not included. Responses may contain more items than the requested limit. Requires authentication

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> GetMutes(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

GetNotificationDeclaration(CancellationToken)

Gets the notification declaration record for the current user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetNotificationDeclaration(Did, CancellationToken)

Gets the notification declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose notification record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetNotificationDeclaration(CancellationToken)

Gets the notification declaration record for the current user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetNotificationDeclaration(Did, CancellationToken)

Gets the notification declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose notification record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetNotificationDeclaration(CancellationToken)

Gets the notification declaration record for the current user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetNotificationDeclaration(Did, CancellationToken)

Gets the notification declaration record for the specified did.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>> GetNotificationDeclaration(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did whose notification record should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Declaration>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

GetNotificationPreferences(CancellationToken)

Gets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> GetNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetNotificationPreferences(CancellationToken)

Gets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> GetNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetNotificationPreferences(CancellationToken)

Gets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> GetNotificationPreferences(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetNotificationUnreadCount(DateTimeOffset?, CancellationToken)

Gets a count the number of unread notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<int?>> GetNotificationUnreadCount(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<int?>>

An idunno.AtProto.AtProtoHttpResult`1 wrapping an integer indicating the unread notification count.

Remarks

The result is null if the API call failed, which is distinct from a successful call which returned a count of zero.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetNotificationUnreadCount(DateTimeOffset?, CancellationToken)

Gets a count the number of unread notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<int?>> GetNotificationUnreadCount(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<int?>>

An idunno.AtProto.AtProtoHttpResult`1 wrapping an integer indicating the unread notification count.

Remarks

The result is null if the API call failed, which is distinct from a successful call which returned a count of zero.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetNotificationUnreadCount(DateTimeOffset?, CancellationToken)

Gets a count the number of unread notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<int?>> GetNotificationUnreadCount(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<int?>>

An idunno.AtProto.AtProtoHttpResult`1 wrapping an integer indicating the unread notification count.

Remarks

The result is null if the API call failed, which is distinct from a successful call which returned a count of zero.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetPopularFeedGenerators(string?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPopularFeedGenerators(string?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get an unspecced, paged list of views over globally popular feed generators.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetPopularFeedGenerators(string? query = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string?

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The maximum number of feed generators to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >100.

GetPopularFeedGenerators(string?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPopularFeedGenerators(string?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get an unspecced, paged list of views over globally popular feed generators.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetPopularFeedGenerators(string? query = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string?

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The maximum number of feed generators to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >100.

GetPopularFeedGenerators(string?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPopularFeedGenerators(string?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get an unspecced, paged list of views over globally popular feed generators.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>> GetPopularFeedGenerators(string? query = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string?

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The maximum number of feed generators to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<GeneratorView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >100.

GetPost(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the post specified by uri.

public Task<AtProtoHttpResult<PostView>> GetPost(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPost(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the post specified by uri.

public Task<AtProtoHttpResult<PostView>> GetPost(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPost(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the post specified by uri.

public Task<AtProtoHttpResult<PostView>> GetPost(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PostGate>> GetPostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PostGate>> GetPostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PostGate>> GetPostGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>> GetPostGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetPostGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdatePostGate(idunno.Bluesky.Feed.Gates.PostGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>> GetPostGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetPostGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdatePostGate(idunno.Bluesky.Feed.Gates.PostGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.PostGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>> GetPostGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose post gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<PostGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetPostGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdatePostGate(idunno.Bluesky.Feed.Gates.PostGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetPostParent(StrongReference, CancellationToken)

Gets a strong reference to parent post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostParent(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the parent strongReference for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostParent(StrongReference, CancellationToken)

Gets a strong reference to parent post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostParent(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the parent strongReference for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostParent(StrongReference, CancellationToken)

Gets a strong reference to parent post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostParent(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the parent strongReference for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRecord(AtUri, Cid?, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(AtUri uri, Cid? cid = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cid Cid?

An optional idunno.AtProto.Cid of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostRecord(StrongReference, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRecord(AtUri, Cid?, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(AtUri uri, Cid? cid = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cid Cid?

An optional idunno.AtProto.Cid of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostRecord(StrongReference, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRecord(AtUri, Cid?, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(AtUri uri, Cid? cid = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cid Cid?

An optional idunno.AtProto.Cid of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostRecord(StrongReference, CancellationToken)

Gets the post record for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>> GetPostRecord(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.AtProto.Repo.AtProtoRepositoryRecord`1 for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Post>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRoot(StrongReference, CancellationToken)

Gets a strong reference to root post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostRoot(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose root idunno.AtProto.Repo.StrongReference should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRoot(StrongReference, CancellationToken)

Gets a strong reference to root post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostRoot(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose root idunno.AtProto.Repo.StrongReference should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostRoot(StrongReference, CancellationToken)

Gets a strong reference to root post for the specified Bluesky post.

public Task<AtProtoHttpResult<StrongReference>> GetPostRoot(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose root idunno.AtProto.Repo.StrongReference should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StrongReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostThread(AtUri, int?, int?, IEnumerable<Did>?, CancellationToken)

Get posts in a thread. Does not require authentication, but additional metadata and filtering will be applied for authenticated requests.

public Task<AtProtoHttpResult<PostThread>> GetPostThread(AtUri uri, int? depth = 6, int? parentHeight = 80, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post record whose thread should be retrieved.

depth int?

How many levels of reply depth should be included in response.

parentHeight int?

How many levels of parent (and grandparent, etc) post to include.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThread>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostThread(AtUri, int?, int?, IEnumerable<Did>?, CancellationToken)

Get posts in a thread. Does not require authentication, but additional metadata and filtering will be applied for authenticated requests.

public Task<AtProtoHttpResult<PostThread>> GetPostThread(AtUri uri, int? depth = 6, int? parentHeight = 80, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post record whose thread should be retrieved.

depth int?

How many levels of reply depth should be included in response.

parentHeight int?

How many levels of parent (and grandparent, etc) post to include.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThread>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostThread(AtUri, int?, int?, IEnumerable<Did>?, CancellationToken)

Get posts in a thread. Does not require authentication, but additional metadata and filtering will be applied for authenticated requests.

public Task<AtProtoHttpResult<PostThread>> GetPostThread(AtUri uri, int? depth = 6, int? parentHeight = 80, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post record whose thread should be retrieved.

depth int?

How many levels of reply depth should be included in response.

parentHeight int?

How many levels of parent (and grandparent, etc) post to include.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThread>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostThreadOtherV2(AtUri, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadOtherV2(idunno.AtProto.AtUri, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get additional posts under a thread e.g. replies hidden by threadgate. Based on an anchor post at any depth of the tree, returns top-level replies below that anchor. It does not include ancestors nor the anchor itself. This should be called after exhausting idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri,System.Nullable{System.Boolean},System.Nullable{System.Int32},System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken). Does not require authentication, but additional metadata and filtering will be applied for authed requests.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>> GetPostThreadOtherV2(AtUri anchor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

GetPostThreadOtherV2(AtUri, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadOtherV2(idunno.AtProto.AtUri, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get additional posts under a thread e.g. replies hidden by threadgate. Based on an anchor post at any depth of the tree, returns top-level replies below that anchor. It does not include ancestors nor the anchor itself. This should be called after exhausting idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri,System.Nullable{System.Boolean},System.Nullable{System.Int32},System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken). Does not require authentication, but additional metadata and filtering will be applied for authed requests.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>> GetPostThreadOtherV2(AtUri anchor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

GetPostThreadOtherV2(AtUri, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadOtherV2(idunno.AtProto.AtUri, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get additional posts under a thread e.g. replies hidden by threadgate. Based on an anchor post at any depth of the tree, returns top-level replies below that anchor. It does not include ancestors nor the anchor itself. This should be called after exhausting idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri,System.Nullable{System.Boolean},System.Nullable{System.Int32},System.Nullable{System.Int32},System.String,System.Collections.Generic.IEnumerable{idunno.AtProto.Did},System.Threading.CancellationToken). Does not require authentication, but additional metadata and filtering will be applied for authed requests.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>> GetPostThreadOtherV2(AtUri anchor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ThreadItem>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

GetPostThreadV2(AtUri, bool?, int?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri, bool?, int?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get posts in a thread. It is based in an anchor post at any depth of the tree, and returns posts above it (recursively resolving the parent, without further branching to their replies) and below it.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PostThreadV2>> GetPostThreadV2(AtUri anchor, bool? above = true, int? below = 6, int? branchingFactor = 10, string? sort = "oldest", IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

above bool?

Flag indicating whether to include parents above the anchor.

below int?

How many levels to include below the anchor. If specified must be between 0 and 20. Specify 0 to retrieve the anchor post without any replies.

branchingFactor int?

Maximum of replies to include at each level of the thread, except for the direct replies to the anchor, which are (NOTE: currently, during unspecced phase) all returned (NOTE: later they might be paginated). If specified must be between 0 and 100.

sort string?

The sort order for the thread. Known values are "newest", "oldest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThreadV2>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

ArgumentOutOfRangeException

Thrown when below or branchingFactor are out of range.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetPostThreadV2(AtUri, bool?, int?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri, bool?, int?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get posts in a thread. It is based in an anchor post at any depth of the tree, and returns posts above it (recursively resolving the parent, without further branching to their replies) and below it.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PostThreadV2>> GetPostThreadV2(AtUri anchor, bool? above = true, int? below = 6, int? branchingFactor = 10, string? sort = "oldest", IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

above bool?

Flag indicating whether to include parents above the anchor.

below int?

How many levels to include below the anchor. If specified must be between 0 and 20. Specify 0 to retrieve the anchor post without any replies.

branchingFactor int?

Maximum of replies to include at each level of the thread, except for the direct replies to the anchor, which are (NOTE: currently, during unspecced phase) all returned (NOTE: later they might be paginated). If specified must be between 0 and 100.

sort string?

The sort order for the thread. Known values are "newest", "oldest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThreadV2>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

ArgumentOutOfRangeException

Thrown when below or branchingFactor are out of range.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetPostThreadV2(AtUri, bool?, int?, int?, string?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetPostThreadV2(idunno.AtProto.AtUri, bool?, int?, int?, string?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get posts in a thread. It is based in an anchor post at any depth of the tree, and returns posts above it (recursively resolving the parent, without further branching to their replies) and below it.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<PostThreadV2>> GetPostThreadV2(AtUri anchor, bool? above = true, int? below = 6, int? branchingFactor = 10, string? sort = "oldest", IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

anchor AtUri

Reference idunno.AtProto.AtUri to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.

above bool?

Flag indicating whether to include parents above the anchor.

below int?

How many levels to include below the anchor. If specified must be between 0 and 20. Specify 0 to retrieve the anchor post without any replies.

branchingFactor int?

Maximum of replies to include at each level of the thread, except for the direct replies to the anchor, which are (NOTE: currently, during unspecced phase) all returned (NOTE: later they might be paginated). If specified must be between 0 and 100.

sort string?

The sort order for the thread. Known values are "newest", "oldest" and "top".

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostThreadV2>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when anchor is null.

ArgumentOutOfRangeException

Thrown when below or branchingFactor are out of range.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetPostView(StrongReference, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(StrongReference strongReference, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostView(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostView(StrongReference, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(StrongReference strongReference, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostView(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPostView(StrongReference, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(StrongReference strongReference, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

The idunno.AtProto.Repo.StrongReference of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetPostView(AtUri, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostView for the specified idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<PostView>> GetPostView(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the post to return the idunno.Bluesky.Feed.PostView for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PostView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetPosts(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostViews for a specified list of posts (by idunno.AtProto.AtUri).

public Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>> GetPosts(IEnumerable<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris IEnumerable<AtUri>

List of post idunno.AtProto.AtUri to return views for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetPosts(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostViews for a specified list of posts (by idunno.AtProto.AtUri).

public Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>> GetPosts(IEnumerable<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris IEnumerable<AtUri>

List of post idunno.AtProto.AtUri to return views for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetPosts(IEnumerable<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets the idunno.Bluesky.Feed.PostViews for a specified list of posts (by idunno.AtProto.AtUri).

public Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>> GetPosts(IEnumerable<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris IEnumerable<AtUri>

List of post idunno.AtProto.AtUri to return views for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<PostView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetPreferences(bool, CancellationToken)

Gets the preferences for the current user.

public Task<AtProtoHttpResult<Preferences>> GetPreferences(bool includeBlueskyModerationLabeler = true, CancellationToken cancellationToken = default)

Parameters

includeBlueskyModerationLabeler bool

Flag indicating whether labeler subscriptions should include the default Bluesky moderation labeler.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetPreferences(bool, CancellationToken)

Gets the preferences for the current user.

public Task<AtProtoHttpResult<Preferences>> GetPreferences(bool includeBlueskyModerationLabeler = true, CancellationToken cancellationToken = default)

Parameters

includeBlueskyModerationLabeler bool

Flag indicating whether labeler subscriptions should include the default Bluesky moderation labeler.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetPreferences(bool, CancellationToken)

Gets the preferences for the current user.

public Task<AtProtoHttpResult<Preferences>> GetPreferences(bool includeBlueskyModerationLabeler = true, CancellationToken cancellationToken = default)

Parameters

includeBlueskyModerationLabeler bool

Flag indicating whether labeler subscriptions should include the default Bluesky moderation labeler.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetProfile(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Gets a idunno.Bluesky.Actor.ProfileViewDetailed for the specified actor.

public Task<AtProtoHttpResult<ProfileViewDetailed>> GetProfile(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor to retrieve the idunno.Bluesky.Actor.ProfileViewDetailed for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ProfileViewDetailed>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetProfile(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfile()

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfile(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Gets a idunno.Bluesky.Actor.ProfileViewDetailed for the specified actor.

public Task<AtProtoHttpResult<ProfileViewDetailed>> GetProfile(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor to retrieve the idunno.Bluesky.Actor.ProfileViewDetailed for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ProfileViewDetailed>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetProfile(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfile()

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfile(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Gets a idunno.Bluesky.Actor.ProfileViewDetailed for the specified actor.

public Task<AtProtoHttpResult<ProfileViewDetailed>> GetProfile(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The actor to retrieve the idunno.Bluesky.Actor.ProfileViewDetailed for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ProfileViewDetailed>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetProfile(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfile()

Gets a idunno.Bluesky.Actor.Profile for the current authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfile()

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown if the agent is not authenticated.

GetProfileRecord(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfileRecord(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetProfileRecord(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfileRecord(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetProfileRecord(CancellationToken)

Gets a idunno.Bluesky.Actor.Profile for the current user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>> GetProfileRecord(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Profile>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetProfiles(IEnumerable<AtIdentifier>, IEnumerable<Did>?, CancellationToken)

Gets idunno.Bluesky.Actor.ProfileViewDetaileds for the specified actors.

public Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>> GetProfiles(IEnumerable<AtIdentifier> actors, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actors IEnumerable<AtIdentifier>

A collection of idunno.AtProto.AtIdentifiers of the actors to return idunno.Bluesky.Actor.ProfileViewDetaileds for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actors is null.

ArgumentOutOfRangeException

Thrown when actors is an empty collection or if it contains >25 handles.

GetProfiles(IEnumerable<AtIdentifier>, IEnumerable<Did>?, CancellationToken)

Gets idunno.Bluesky.Actor.ProfileViewDetaileds for the specified actors.

public Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>> GetProfiles(IEnumerable<AtIdentifier> actors, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actors IEnumerable<AtIdentifier>

A collection of idunno.AtProto.AtIdentifiers of the actors to return idunno.Bluesky.Actor.ProfileViewDetaileds for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actors is null.

ArgumentOutOfRangeException

Thrown when actors is an empty collection or if it contains >25 handles.

GetProfiles(IEnumerable<AtIdentifier>, IEnumerable<Did>?, CancellationToken)

Gets idunno.Bluesky.Actor.ProfileViewDetaileds for the specified actors.

public Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>> GetProfiles(IEnumerable<AtIdentifier> actors, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actors IEnumerable<AtIdentifier>

A collection of idunno.AtProto.AtIdentifiers of the actors to return idunno.Bluesky.Actor.ProfileViewDetaileds for.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyCollection<ProfileViewDetailed>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actors is null.

ArgumentOutOfRangeException

Thrown when actors is an empty collection or if it contains >25 handles.

GetQuotes(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of quotes for a given post.

public Task<AtProtoHttpResult<QuotesCollection>> GetQuotes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose quotes should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<QuotesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetQuotes(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of quotes for a given post.

public Task<AtProtoHttpResult<QuotesCollection>> GetQuotes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose quotes should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<QuotesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetQuotes(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of quotes for a given post.

public Task<AtProtoHttpResult<QuotesCollection>> GetQuotes(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose quotes should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<QuotesCollection>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetRelationships(AtIdentifier, ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between one account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(AtIdentifier actor, ICollection<AtIdentifier> others, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

others ICollection<AtIdentifier>

A list of other accounts to be related back to actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor or others is null.

GetRelationships(ICollection<AtIdentifier>)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetRelationships(ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others, CancellationToken cancellationToken)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetRelationships(AtIdentifier, ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between one account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(AtIdentifier actor, ICollection<AtIdentifier> others, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

others ICollection<AtIdentifier>

A list of other accounts to be related back to actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor or others is null.

GetRelationships(ICollection<AtIdentifier>)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetRelationships(ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others, CancellationToken cancellationToken)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetRelationships(AtIdentifier, ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between one account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(AtIdentifier actor, ICollection<AtIdentifier> others, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

others ICollection<AtIdentifier>

A list of other accounts to be related back to actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor or others is null.

GetRelationships(ICollection<AtIdentifier>)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetRelationships(ICollection<AtIdentifier>, CancellationToken)

Enumerates public relationships between the current account, and a list of other accounts.

public Task<AtProtoHttpResult<RelationshipMap>> GetRelationships(ICollection<AtIdentifier> others, CancellationToken cancellationToken)

Parameters

others ICollection<AtIdentifier>

A list of other accounts to be related back to current actor.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RelationshipMap>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when others is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetReplyReferences(StrongReference, CancellationToken)

Gets the idunno.Bluesky.ReplyReferences for the specified Bluesky post, suitable for using when making a reply post.

public Task<AtProtoHttpResult<ReplyReferences>> GetReplyReferences(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose idunno.Bluesky.ReplyReferences should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ReplyReferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetReplyReferences(StrongReference, CancellationToken)

Gets the idunno.Bluesky.ReplyReferences for the specified Bluesky post, suitable for using when making a reply post.

public Task<AtProtoHttpResult<ReplyReferences>> GetReplyReferences(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose idunno.Bluesky.ReplyReferences should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ReplyReferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetReplyReferences(StrongReference, CancellationToken)

Gets the idunno.Bluesky.ReplyReferences for the specified Bluesky post, suitable for using when making a reply post.

public Task<AtProtoHttpResult<ReplyReferences>> GetReplyReferences(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post whose idunno.Bluesky.ReplyReferences should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ReplyReferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when strongReference is null.

GetRepostedBy(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of profiles who reposted the specified post.

public Task<AtProtoHttpResult<RepostedBy>> GetRepostedBy(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose repost authors should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RepostedBy>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetRepostedBy(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of profiles who reposted the specified post.

public Task<AtProtoHttpResult<RepostedBy>> GetRepostedBy(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose repost authors should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RepostedBy>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetRepostedBy(AtUri, Cid?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of profiles who reposted the specified post.

public Task<AtProtoHttpResult<RepostedBy>> GetRepostedBy(AtUri uri, Cid? cid = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

idunno.AtProto.AtUri of post record whose repost authors should be retrieved.

cid Cid?

If supplied, filters to quotes of specific version (by content identifier) of the post record.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RepostedBy>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null.

GetStarterPack(AtUri, IEnumerable<Did>?, CancellationToken)

Gets a view of a starter pack.

public Task<AtProtoHttpResult<StarterPackView>> GetStarterPack(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the starter pack to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StarterPackView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null

GetStarterPack(AtUri, IEnumerable<Did>?, CancellationToken)

Gets a view of a starter pack.

public Task<AtProtoHttpResult<StarterPackView>> GetStarterPack(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the starter pack to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StarterPackView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null

GetStarterPack(AtUri, IEnumerable<Did>?, CancellationToken)

Gets a view of a starter pack.

public Task<AtProtoHttpResult<StarterPackView>> GetStarterPack(AtUri uri, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the starter pack to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StarterPackView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri is null

GetStarterPacks(ICollection<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets a basic view of the specified starter packs.

public Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>> GetStarterPacks(ICollection<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris ICollection<AtUri>

A collection of idunno.AtProto.AtUris for the starter packs to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetStarterPacks(ICollection<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets a basic view of the specified starter packs.

public Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>> GetStarterPacks(ICollection<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris ICollection<AtUri>

A collection of idunno.AtProto.AtUris for the starter packs to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetStarterPacks(ICollection<AtUri>, IEnumerable<Did>?, CancellationToken)

Gets a basic view of the specified starter packs.

public Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>> GetStarterPacks(ICollection<AtUri> uris, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

uris ICollection<AtUri>

A collection of idunno.AtProto.AtUris for the starter packs to view.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uris is null.

GetStarterPacksWithMembership(AtIdentifier, int?, string?, CancellationToken)

Enumerates the starter packs created by the authenticated user, and includes membership information about actor in those starter packs. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>> GetStarterPacksWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetStarterPacksWithMembership(AtIdentifier, int?, string?, CancellationToken)

Enumerates the starter packs created by the authenticated user, and includes membership information about actor in those starter packs. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>> GetStarterPacksWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetStarterPacksWithMembership(AtIdentifier, int?, string?, CancellationToken)

Enumerates the starter packs created by the authenticated user, and includes membership information about actor in those starter packs. Requires authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>> GetStarterPacksWithMembership(AtIdentifier actor, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor whose follows should be enumerated.

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackWithMembership>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

GetStatus(CancellationToken)

Gets the current profile status, if any, for the authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>> GetStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetStatus(CancellationToken)

Gets the current profile status, if any, for the authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>> GetStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetStatus(CancellationToken)

Gets the current profile status, if any, for the authenticated user.

public Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>> GetStatus(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<Status>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestedFeeds(IEnumerable<Did>?, CancellationToken)

Get a list of suggested feeds for the current user

public Task<AtProtoHttpResult<SuggestedFeeds>> GetSuggestedFeeds(IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedFeeds>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetSuggestedFeeds(IEnumerable<Did>?, CancellationToken)

Get a list of suggested feeds for the current user

public Task<AtProtoHttpResult<SuggestedFeeds>> GetSuggestedFeeds(IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedFeeds>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetSuggestedFeeds(IEnumerable<Did>?, CancellationToken)

Get a list of suggested feeds for the current user

public Task<AtProtoHttpResult<SuggestedFeeds>> GetSuggestedFeeds(IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedFeeds>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetSuggestedFollowsByActor(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

public Task<AtProtoHttpResult<SuggestedActors>> GetSuggestedFollowsByActor(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account to enumerate suggested follows for.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedActors>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetSuggestedFollowsByActor(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

public Task<AtProtoHttpResult<SuggestedActors>> GetSuggestedFollowsByActor(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account to enumerate suggested follows for.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedActors>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetSuggestedFollowsByActor(AtIdentifier, IEnumerable<Did>?, CancellationToken)

Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.

public Task<AtProtoHttpResult<SuggestedActors>> GetSuggestedFollowsByActor(AtIdentifier actor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The account to enumerate suggested follows for.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedActors>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

GetSuggestedStarterPacks(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedStarterPacks(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a System.Collections.Generic.ICollection`1 of idunno.Bluesky.Graph.StarterPackViews of suggested starter packs.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<StarterPackView>>> GetSuggestedStarterPacks(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of starter packs to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<StarterPackView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetSuggestedStarterPacks(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedStarterPacks(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a System.Collections.Generic.ICollection`1 of idunno.Bluesky.Graph.StarterPackViews of suggested starter packs.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<StarterPackView>>> GetSuggestedStarterPacks(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of starter packs to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<StarterPackView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetSuggestedStarterPacks(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedStarterPacks(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a System.Collections.Generic.ICollection`1 of idunno.Bluesky.Graph.StarterPackViews of suggested starter packs.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<StarterPackView>>> GetSuggestedStarterPacks(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of starter packs to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<StarterPackView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetSuggestedUsers(string?, int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedUsers(string?, int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a idunno.AtProto.PagedReadOnlyCollection`1 of idunno.Bluesky.Actor.ProfileViews of suggested actors.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>> GetSuggestedUsers(string? category = null, int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

category string?

An optional category of users to get suggestions for.

limit int?

The number of topics to return. Must be between 1 and 50.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >50.

GetSuggestedUsers(string?, int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedUsers(string?, int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a idunno.AtProto.PagedReadOnlyCollection`1 of idunno.Bluesky.Actor.ProfileViews of suggested actors.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>> GetSuggestedUsers(string? category = null, int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

category string?

An optional category of users to get suggestions for.

limit int?

The number of topics to return. Must be between 1 and 50.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >50.

GetSuggestedUsers(string?, int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetSuggestedUsers(string?, int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a idunno.AtProto.PagedReadOnlyCollection`1 of idunno.Bluesky.Actor.ProfileViews of suggested actors.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>> GetSuggestedUsers(string? category = null, int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

category string?

An optional category of users to get suggestions for.

limit int?

The number of topics to return. Must be between 1 and 50.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >50.

GetSuggestions(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(int? limit, string? cursor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestions(string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestions(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(int? limit, string? cursor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestions(string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestions(int?, string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(int? limit, string? cursor, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetSuggestions(string?, IEnumerable<Did>?, CancellationToken)

Get a list of suggested actors for the authenticator users. The expected use is discovery of accounts to follow during new account onboarding.

public Task<AtProtoHttpResult<SuggestedProfiles>> GetSuggestions(string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SuggestedProfiles>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTaggedSuggestions(System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string, object>>?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of tagged suggestions.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<Suggestion>>> GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>? parameters = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

parameters ICollection<KeyValuePair<string, object>>?

Any parameters to send to the endpoint. Parameter names and values will automatically be query string encoded.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<Suggestion>>>

The task object representing the asynchronous operation.

GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTaggedSuggestions(System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string, object>>?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of tagged suggestions.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<Suggestion>>> GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>? parameters = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

parameters ICollection<KeyValuePair<string, object>>?

Any parameters to send to the endpoint. Parameter names and values will automatically be query string encoded.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<Suggestion>>>

The task object representing the asynchronous operation.

GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTaggedSuggestions(System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string, object>>?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of tagged suggestions.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<ICollection<Suggestion>>> GetTaggedSuggestions(ICollection<KeyValuePair<string, object>>? parameters = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

parameters ICollection<KeyValuePair<string, object>>?

Any parameters to send to the endpoint. Parameter names and values will automatically be query string encoded.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<Suggestion>>>

The task object representing the asynchronous operation.

GetThreadGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<ThreadGate>> GetThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ThreadGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetThreadGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<ThreadGate>> GetThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ThreadGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetThreadGate(AtUri, CancellationToken)

Gets the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<ThreadGate>> GetThreadGate(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ThreadGate>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetThreadGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>> GetThreadGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetThreadGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdateThreadGate(idunno.Bluesky.Feed.Gates.ThreadGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetThreadGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>> GetThreadGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetThreadGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdateThreadGate(idunno.Bluesky.Feed.Gates.ThreadGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetThreadGateRecord(AtUri, CancellationToken)

Gets the repository record holding the idunno.Bluesky.Feed.Gates.ThreadGate for the specified post, if any.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>> GetThreadGateRecord(AtUri post, CancellationToken cancellationToken = default)

Parameters

post AtUri

The idunno.AtProto.AtUri for the post whose thread gate should be retrieved.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<AtProtoRepositoryRecord<ThreadGate>>>

The task object representing the asynchronous operation.

Remarks

Unlike idunno.Bluesky.BlueskyAgent.GetThreadGate(idunno.AtProto.AtUri,System.Threading.CancellationToken) the returned record carries its idunno.AtProto.Cid, which idunno.Bluesky.BlueskyAgent.UpdateThreadGate(idunno.Bluesky.Feed.Gates.ThreadGate,idunno.AtProto.Cid,System.Threading.CancellationToken) takes as a swapRecord to make an update conditional.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when post does not point to a post record, or its RecordKey is null.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

GetTimeline(string?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

public Task<AtProtoHttpResult<Timeline>> GetTimeline(string? algorithm = null, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

algorithm string?

Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Timeline>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetTimeline(string?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

public Task<AtProtoHttpResult<Timeline>> GetTimeline(string? algorithm = null, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

algorithm string?

Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Timeline>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetTimeline(string?, int?, string?, IEnumerable<Did>?, CancellationToken)

Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

public Task<AtProtoHttpResult<Timeline>> GetTimeline(string? algorithm = null, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

algorithm string?

Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.

limit int?

The maximum number of posts to return.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Timeline>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetTrendingTopics(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrendingTopics(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trending topics

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<TrendingTopics>> GetTrendingTopics(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TrendingTopics>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetTrendingTopics(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrendingTopics(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trending topics

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<TrendingTopics>> GetTrendingTopics(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TrendingTopics>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetTrendingTopics(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrendingTopics(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trending topics

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<TrendingTopics>> GetTrendingTopics(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<TrendingTopics>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetTrends(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrends(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trends.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>> GetTrends(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetTrends(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrends(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trends.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>> GetTrends(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetTrends(int?, IEnumerable<Did>?, CancellationToken) Preview

BSKYUnspecced: 'idunno.Bluesky.BlueskyAgent.GetTrends(int?, System.Collections.Generic.IEnumerable<idunno.AtProto.Did>?, System.Threading.CancellationToken)' is for evaluation purposes only and is subject to change or removal in future updates.

Get a collection of trends.

[Experimental("BSKYUnspecced", UrlFormat = "https://bluesky.idunno.dev/docs/unspecced.html")]
public Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>> GetTrends(int? limit = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of topics to return. Must be between 1 and 25.

subscribedLabelers IEnumerable<Did>?

An optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RecommendationReadOnlyCollection<TrendView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit is < 1 or >25.

GetUnreadCounts(bool, CancellationToken)

Gets the count of unread conversations for the authenticated user.

public Task<AtProtoHttpResult<UnreadConversationCounts>> GetUnreadCounts(bool includeGroupChats = true, CancellationToken cancellationToken = default)

Parameters

includeGroupChats bool

Flag indicating whether to include group conversations. When false, group conversations are excluded from the counts.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UnreadConversationCounts>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetUnreadCounts(bool, CancellationToken)

Gets the count of unread conversations for the authenticated user.

public Task<AtProtoHttpResult<UnreadConversationCounts>> GetUnreadCounts(bool includeGroupChats = true, CancellationToken cancellationToken = default)

Parameters

includeGroupChats bool

Flag indicating whether to include group conversations. When false, group conversations are excluded from the counts.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UnreadConversationCounts>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetUnreadCounts(bool, CancellationToken)

Gets the count of unread conversations for the authenticated user.

public Task<AtProtoHttpResult<UnreadConversationCounts>> GetUnreadCounts(bool includeGroupChats = true, CancellationToken cancellationToken = default)

Parameters

includeGroupChats bool

Flag indicating whether to include group conversations. When false, group conversations are excluded from the counts.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UnreadConversationCounts>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

GetUploadLimits(CancellationToken)

Gets any video upload restrictions placed on the current user

public Task<AtProtoHttpResult<UploadLimits>> GetUploadLimits(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadLimits>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetUploadLimits(CancellationToken)

Gets any video upload restrictions placed on the current user

public Task<AtProtoHttpResult<UploadLimits>> GetUploadLimits(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadLimits>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetUploadLimits(CancellationToken)

Gets any video upload restrictions placed on the current user

public Task<AtProtoHttpResult<UploadLimits>> GetUploadLimits(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadLimits>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

GetUploadStatus(string, CancellationToken)

Gets the authoritative upload-phase status for the specified multipart video upload.

public Task<AtProtoHttpResult<UploadStatus>> GetUploadStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetUploadStatus(string, CancellationToken)

Gets the authoritative upload-phase status for the specified multipart video upload.

public Task<AtProtoHttpResult<UploadStatus>> GetUploadStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetUploadStatus(string, CancellationToken)

Gets the authoritative upload-phase status for the specified multipart video upload.

public Task<AtProtoHttpResult<UploadStatus>> GetUploadStatus(string jobId, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id whose status should be queried.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when jobId is null or whitespace.

GetUserSubscribedLabelerServices(CancellationToken)

Gets detailed information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>> GetUserSubscribedLabelerServices(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetUserSubscribedLabelerServices(CancellationToken)

Gets detailed information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>> GetUserSubscribedLabelerServices(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

GetUserSubscribedLabelerServices(CancellationToken)

Gets detailed information about the labeler services that the current user subscribes to.

public Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>> GetUserSubscribedLabelerServices(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<LabelerViewDetailed>>>

The task object representing the asynchronous operation.

Remarks

If the current user subscribes to no labelers an empty collection is returned, rather than a request being made with no labeler idunno.AtProto.Dids.

Exceptions

AuthenticationRequiredException

Thrown when this instance of the agent is not authenticated.

LeaveConversation(string, CancellationToken)

Leaves the conversation identified by id.

public Task<AtProtoHttpResult<ConversationReference>> LeaveConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to leave.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LeaveConversation(string, CancellationToken)

Leaves the conversation identified by id.

public Task<AtProtoHttpResult<ConversationReference>> LeaveConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to leave.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LeaveConversation(string, CancellationToken)

Leaves the conversation identified by id.

public Task<AtProtoHttpResult<ConversationReference>> LeaveConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to leave.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationReference>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

Like(StrongReference, CancellationToken)

Creates a like record in the current user's repo for the record pointed to by the strongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when strongReference or its idunno.AtProto.Repo.StrongReference.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the strongReference does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(AtUri, Cid, CancellationToken)

Creates a like record in the current user's repo for the post pointed to by the uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be liked.

cid Cid

The idunno.AtProto.Cid of the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(PostView, CancellationToken)

Creates a like record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, the idunno.Bluesky.Feed.PostView.Uri property, or the idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(FeedViewPost, CancellationToken)

Creates a like record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property, or it's collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

Like(StrongReference, CancellationToken)

Creates a like record in the current user's repo for the record pointed to by the strongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when strongReference or its idunno.AtProto.Repo.StrongReference.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the strongReference does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(AtUri, Cid, CancellationToken)

Creates a like record in the current user's repo for the post pointed to by the uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be liked.

cid Cid

The idunno.AtProto.Cid of the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(PostView, CancellationToken)

Creates a like record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, the idunno.Bluesky.Feed.PostView.Uri property, or the idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(FeedViewPost, CancellationToken)

Creates a like record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property, or it's collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

Like(StrongReference, CancellationToken)

Creates a like record in the current user's repo for the record pointed to by the strongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(StrongReference strongReference, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when strongReference or its idunno.AtProto.Repo.StrongReference.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the strongReference does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(AtUri, Cid, CancellationToken)

Creates a like record in the current user's repo for the post pointed to by the uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be liked.

cid Cid

The idunno.AtProto.Cid of the record to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Like(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure likes of reposted posts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(PostView, CancellationToken)

Creates a like record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, the idunno.Bluesky.Feed.PostView.Uri property, or the idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Like(FeedViewPost, CancellationToken)

Creates a like record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Like(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property, or it's collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

ListActivitySubscriptions(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets the activity subscriptions for the requesting account.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> ListActivitySubscriptions(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of activity subscriptions to return. If specified this should be greater than 1 and less than or equal to 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit<1 or limit>100.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

ListActivitySubscriptions(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets the activity subscriptions for the requesting account.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> ListActivitySubscriptions(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of activity subscriptions to return. If specified this should be greater than 1 and less than or equal to 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit<1 or limit>100.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

ListActivitySubscriptions(int?, string?, IEnumerable<Did>?, CancellationToken)

Gets the activity subscriptions for the requesting account.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> ListActivitySubscriptions(int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of activity subscriptions to return. If specified this should be greater than 1 and less than or equal to 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when limit<1 or limit>100.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

ListBlueskyRecords<TRecord>(AtIdentifier, Nsid, int?, string?, bool, Uri?, string?, CancellationToken)

Gets a page of records in the specified collection.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>> ListBlueskyRecords<TRecord>(AtIdentifier repo, Nsid collection, int? limit = 50, string? cursor = null, bool reverse = false, Uri? service = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the records from.

collection Nsid

The NSID of the collection the records should be retrieved from.

limit int?

The number of records to return in each page.

cursor string?

The cursor position to start retrieving records from.

reverse bool

A flag indicating if records should be listed in reverse order.

service Uri?

The service to retrieve the records from. If null it will be resolved from repo.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of the record value to get.

Exceptions

ArgumentNullException

Thrown when repo or collection is null.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

ListBlueskyRecords<TRecord>(AtIdentifier, Nsid, int?, string?, bool, Uri?, string?, CancellationToken)

Gets a page of records in the specified collection.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>> ListBlueskyRecords<TRecord>(AtIdentifier repo, Nsid collection, int? limit = 50, string? cursor = null, bool reverse = false, Uri? service = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the records from.

collection Nsid

The NSID of the collection the records should be retrieved from.

limit int?

The number of records to return in each page.

cursor string?

The cursor position to start retrieving records from.

reverse bool

A flag indicating if records should be listed in reverse order.

service Uri?

The service to retrieve the records from. If null it will be resolved from repo.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of the record value to get.

Exceptions

ArgumentNullException

Thrown when repo or collection is null.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

ListBlueskyRecords<TRecord>(AtIdentifier, Nsid, int?, string?, bool, Uri?, string?, CancellationToken)

Gets a page of records in the specified collection.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the BlueskyServer.BlueskyJsonSerializerOptions passed to ListRecords().")]
public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>> ListBlueskyRecords<TRecord>(AtIdentifier repo, Nsid collection, int? limit = 50, string? cursor = null, bool reverse = false, Uri? service = null, string? serviceProxy = null, CancellationToken cancellationToken = default) where TRecord : BlueskyRecord

Parameters

repo AtIdentifier

The idunno.AtProto.AtIdentifier of the repo to retrieve the records from.

collection Nsid

The NSID of the collection the records should be retrieved from.

limit int?

The number of records to return in each page.

cursor string?

The cursor position to start retrieving records from.

reverse bool

A flag indicating if records should be listed in reverse order.

service Uri?

The service to retrieve the records from. If null it will be resolved from repo.

serviceProxy string?

The service the PDS should proxy the call to, if any.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<TRecord>>>>

The task object representing the asynchronous operation.

Type Parameters

TRecord

The type of the record value to get.

Exceptions

ArgumentNullException

Thrown when repo or collection is null.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

ListConversationRequests(int?, string?, CancellationToken)

Returns a page of incoming conversation requests for the user. Direct conversation requests are returned as idunno.Bluesky.Chat.ConversationView; group join requests made by the user are returned as idunno.Bluesky.Chat.Group.JoinRequestConversationView.

The behavior above, from the lexicon does not match the actual API behavior, which returns all requests as idunno.Bluesky.Chat.ConversationView. See https://github.com/bluesky-social/atproto/issues/5175.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>> ListConversationRequests(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of requests to return. Must be between 1 and 100.

cursor string?

The cursor to use for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when the limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListConversationRequests(int?, string?, CancellationToken)

Returns a page of incoming conversation requests for the user. Direct conversation requests are returned as idunno.Bluesky.Chat.ConversationView; group join requests made by the user are returned as idunno.Bluesky.Chat.Group.JoinRequestConversationView.

The behavior above, from the lexicon does not match the actual API behavior, which returns all requests as idunno.Bluesky.Chat.ConversationView. See https://github.com/bluesky-social/atproto/issues/5175.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>> ListConversationRequests(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of requests to return. Must be between 1 and 100.

cursor string?

The cursor to use for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when the limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListConversationRequests(int?, string?, CancellationToken)

Returns a page of incoming conversation requests for the user. Direct conversation requests are returned as idunno.Bluesky.Chat.ConversationView; group join requests made by the user are returned as idunno.Bluesky.Chat.Group.JoinRequestConversationView.

The behavior above, from the lexicon does not match the actual API behavior, which returns all requests as idunno.Bluesky.Chat.ConversationView. See https://github.com/bluesky-social/atproto/issues/5175.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>> ListConversationRequests(int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of requests to return. Must be between 1 and 100.

cursor string?

The cursor to use for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationViewBase>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when the limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListConversations(int?, string?, string?, string?, string?, string?, CancellationToken)

Enumerates a list of conversations the current user is a part of.

public Task<AtProtoHttpResult<Conversations>> ListConversations(int? limit = null, string? cursor = null, string? readState = null, string? status = null, string? kind = null, string? lockStatus = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of conversations to return.

cursor string?

A cursor used for pagination.

readState string?

An optional filter limiting the results to conversations in the specified read state. Known values are defined in idunno.Bluesky.Chat.ConversationReadState.

status string?

An optional filter limiting the results to conversations with the specified status. Known values are defined in idunno.Bluesky.Chat.ConversationStatus.

kind string?

An optional filter limiting the results to conversations of the specified kind. Known values are defined in idunno.Bluesky.Chat.ConversationKind.

lockStatus string?

An optional filter limiting the results to conversations with the specified lock status. Known values are defined in idunno.Bluesky.Chat.ConversationLockStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Conversations>>

The task object representing the asynchronous operation.

Remarks

Setting status to idunno.Bluesky.Chat.ConversationStatus.Requested is discouraged. Use idunno.Bluesky.BlueskyAgent.ListConversationRequests(System.Nullable{System.Int32},System.String,System.Threading.CancellationToken) instead, which also includes group join requests made by the user.

Exceptions

ArgumentException

Thrown when any of readState, status, kind or lockStatus is specified and is whitespace.

ArgumentOutOfRangeException

Thrown when limitis <1 or > the maximum number of conversations to list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListConversations(int?, string?, string?, string?, string?, string?, CancellationToken)

Enumerates a list of conversations the current user is a part of.

public Task<AtProtoHttpResult<Conversations>> ListConversations(int? limit = null, string? cursor = null, string? readState = null, string? status = null, string? kind = null, string? lockStatus = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of conversations to return.

cursor string?

A cursor used for pagination.

readState string?

An optional filter limiting the results to conversations in the specified read state. Known values are defined in idunno.Bluesky.Chat.ConversationReadState.

status string?

An optional filter limiting the results to conversations with the specified status. Known values are defined in idunno.Bluesky.Chat.ConversationStatus.

kind string?

An optional filter limiting the results to conversations of the specified kind. Known values are defined in idunno.Bluesky.Chat.ConversationKind.

lockStatus string?

An optional filter limiting the results to conversations with the specified lock status. Known values are defined in idunno.Bluesky.Chat.ConversationLockStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Conversations>>

The task object representing the asynchronous operation.

Remarks

Setting status to idunno.Bluesky.Chat.ConversationStatus.Requested is discouraged. Use idunno.Bluesky.BlueskyAgent.ListConversationRequests(System.Nullable{System.Int32},System.String,System.Threading.CancellationToken) instead, which also includes group join requests made by the user.

Exceptions

ArgumentException

Thrown when any of readState, status, kind or lockStatus is specified and is whitespace.

ArgumentOutOfRangeException

Thrown when limitis <1 or > the maximum number of conversations to list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListConversations(int?, string?, string?, string?, string?, string?, CancellationToken)

Enumerates a list of conversations the current user is a part of.

public Task<AtProtoHttpResult<Conversations>> ListConversations(int? limit = null, string? cursor = null, string? readState = null, string? status = null, string? kind = null, string? lockStatus = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The number of conversations to return.

cursor string?

A cursor used for pagination.

readState string?

An optional filter limiting the results to conversations in the specified read state. Known values are defined in idunno.Bluesky.Chat.ConversationReadState.

status string?

An optional filter limiting the results to conversations with the specified status. Known values are defined in idunno.Bluesky.Chat.ConversationStatus.

kind string?

An optional filter limiting the results to conversations of the specified kind. Known values are defined in idunno.Bluesky.Chat.ConversationKind.

lockStatus string?

An optional filter limiting the results to conversations with the specified lock status. Known values are defined in idunno.Bluesky.Chat.ConversationLockStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Conversations>>

The task object representing the asynchronous operation.

Remarks

Setting status to idunno.Bluesky.Chat.ConversationStatus.Requested is discouraged. Use idunno.Bluesky.BlueskyAgent.ListConversationRequests(System.Nullable{System.Int32},System.String,System.Threading.CancellationToken) instead, which also includes group join requests made by the user.

Exceptions

ArgumentException

Thrown when any of readState, status, kind or lockStatus is specified and is whitespace.

ArgumentOutOfRangeException

Thrown when limitis <1 or > the maximum number of conversations to list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListJoinGroupRequests(string, int?, string?, CancellationToken)

Lists a page of requests as a idunno.Bluesky.PagedViewReadOnlyCollection`1 to join a group (via join link) the user owns. Shows the data from the owner's point of view.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>> ListJoinGroupRequests(string conversationId, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to list join requests for.

limit int?

The maximum number of join requests to return. Must be between 1 and 100.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId is null.

ArgumentException

Thrown when conversationId is empty.

ArgumentOutOfRangeException

Thrown when limit is out of range.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListJoinGroupRequests(string, int?, string?, CancellationToken)

Lists a page of requests as a idunno.Bluesky.PagedViewReadOnlyCollection`1 to join a group (via join link) the user owns. Shows the data from the owner's point of view.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>> ListJoinGroupRequests(string conversationId, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to list join requests for.

limit int?

The maximum number of join requests to return. Must be between 1 and 100.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId is null.

ArgumentException

Thrown when conversationId is empty.

ArgumentOutOfRangeException

Thrown when limit is out of range.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListJoinGroupRequests(string, int?, string?, CancellationToken)

Lists a page of requests as a idunno.Bluesky.PagedViewReadOnlyCollection`1 to join a group (via join link) the user owns. Shows the data from the owner's point of view.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>> ListJoinGroupRequests(string conversationId, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the conversation to list join requests for.

limit int?

The maximum number of join requests to return. Must be between 1 and 100.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<JoinRequestView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId is null.

ArgumentException

Thrown when conversationId is empty.

ArgumentOutOfRangeException

Thrown when limit is out of range.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListMutualGroups(Did, int?, string?, CancellationToken)

Lists a page of mutual groups as a idunno.Bluesky.PagedViewReadOnlyCollection`1 for the specified user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>> ListMutualGroups(Did subject, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the user to list mutual groups for.

limit int?

An optional limit for the number of items to return.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListMutualGroups(Did, int?, string?, CancellationToken)

Lists a page of mutual groups as a idunno.Bluesky.PagedViewReadOnlyCollection`1 for the specified user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>> ListMutualGroups(Did subject, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the user to list mutual groups for.

limit int?

An optional limit for the number of items to return.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListMutualGroups(Did, int?, string?, CancellationToken)

Lists a page of mutual groups as a idunno.Bluesky.PagedViewReadOnlyCollection`1 for the specified user.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>> ListMutualGroups(Did subject, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the user to list mutual groups for.

limit int?

An optional limit for the number of items to return.

cursor string?

An optional cursor used for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ConversationView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

ListNotifications(int?, string?, IEnumerable<NotificationReason>?, IEnumerable<Did>?, CancellationToken)

Gets the notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<NotificationCollection>> ListNotifications(int? limit = null, string? cursor = null, IEnumerable<NotificationReason>? reasons = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of notifications to return. If specified this should be >=1 and <= 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

reasons IEnumerable<NotificationReason>?

An optional collection of idunno.Bluesky.Notifications.NotificationReasons to limit the results to.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<NotificationCollection>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

ArgumentException

Thrown when reasons contains idunno.Bluesky.Notifications.NotificationReason.Unknown.

ListNotifications(int?, string?, IEnumerable<NotificationReason>?, IEnumerable<Did>?, CancellationToken)

Gets the notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<NotificationCollection>> ListNotifications(int? limit = null, string? cursor = null, IEnumerable<NotificationReason>? reasons = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of notifications to return. If specified this should be >=1 and <= 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

reasons IEnumerable<NotificationReason>?

An optional collection of idunno.Bluesky.Notifications.NotificationReasons to limit the results to.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<NotificationCollection>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

ArgumentException

Thrown when reasons contains idunno.Bluesky.Notifications.NotificationReason.Unknown.

ListNotifications(int?, string?, IEnumerable<NotificationReason>?, IEnumerable<Did>?, CancellationToken)

Gets the notifications for the requesting account. Requires authentication.

public Task<AtProtoHttpResult<NotificationCollection>> ListNotifications(int? limit = null, string? cursor = null, IEnumerable<NotificationReason>? reasons = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

limit int?

The maximum number of notifications to return. If specified this should be >=1 and <= 100.

cursor string?

An optional cursor. See https://atproto.com/specs/xrpc#cursors-and-pagination.

reasons IEnumerable<NotificationReason>?

An optional collection of idunno.Bluesky.Notifications.NotificationReasons to limit the results to.

subscribedLabelers IEnumerable<Did>?

A optional list of labeler idunno.AtProto.Dids to accept labels from.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<NotificationCollection>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

ArgumentException

Thrown when reasons contains idunno.Bluesky.Notifications.NotificationReason.Unknown.

ListReferenceListOptOuts(int?, CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit, CancellationToken cancellationToken)

Parameters

limit int?

The maximum number of records to return.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(int?)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit)

Parameters

limit int?

The maximum number of records to return.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts()

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts()

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(int?, CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit, CancellationToken cancellationToken)

Parameters

limit int?

The maximum number of records to return.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(int?)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit)

Parameters

limit int?

The maximum number of records to return.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts()

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts()

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(int?, CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit, CancellationToken cancellationToken)

Parameters

limit int?

The maximum number of records to return.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(int?)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(int? limit)

Parameters

limit int?

The maximum number of records to return.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts(CancellationToken)

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ListReferenceListOptOuts()

Gets a list of reference list opt-outs for the current user.

public Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>> ListReferenceListOptOuts()

Returns

Task<AtProtoHttpResult<PagedReadOnlyCollection<AtProtoRepositoryRecord<ReferenceListOptOut>>>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LockConversation(string, CancellationToken)

Locks a conversation.

public Task<AtProtoHttpResult<ConversationView>> LockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to lock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LockConversation(string, CancellationToken)

Locks a conversation.

public Task<AtProtoHttpResult<ConversationView>> LockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to lock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LockConversation(string, CancellationToken)

Locks a conversation.

public Task<AtProtoHttpResult<ConversationView>> LockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to lock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

LookupDid(Did, CancellationToken)

Performs a reverse lookup on a idunno.AtProto.Did and returns its handle.

public Task<Handle?> LookupDid(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did to lookup.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<Handle?>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when did is null.

LookupDid(Did, CancellationToken)

Performs a reverse lookup on a idunno.AtProto.Did and returns its handle.

public Task<Handle?> LookupDid(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did to lookup.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<Handle?>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when did is null.

LookupDid(Did, CancellationToken)

Performs a reverse lookup on a idunno.AtProto.Did and returns its handle.

public Task<Handle?> LookupDid(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did to lookup.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<Handle?>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when did is null.

Mute(AtIdentifier, CancellationToken)

Completely mutes the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Mute(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Mute(AtIdentifier, CancellationToken)

Completely mutes the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Mute(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Mute(AtIdentifier, CancellationToken)

Completely mutes the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Mute(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Mute(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, CancellationToken)

Completely mutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, CancellationToken)

Completely mutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, CancellationToken)

Completely mutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActor(AtIdentifier, bool?, bool?, CancellationToken)

Creates or updates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActor(AtIdentifier actor, bool? onlyReposts, bool? onlyQuotePosts, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to mute.

onlyReposts bool?

Flag indicating whether to restrict the mute to the account's reposts. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

onlyQuotePosts bool?

Flag indicating whether to restrict the mute to the account's quotes. When true, just the scoped content is muted; when no scoped mutes are set the account is fully muted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActorList(AtUri, CancellationToken)

Creates a mute relationship for the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActorList(AtUri, CancellationToken)

Creates a mute relationship for the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteActorList(AtUri, CancellationToken)

Creates a mute relationship for the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteConversation(string, CancellationToken)

Mutes the conversation identified by id.

public Task<AtProtoHttpResult<ConversationView>> MuteConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

MuteConversation(string, CancellationToken)

Mutes the conversation identified by id.

public Task<AtProtoHttpResult<ConversationView>> MuteConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

MuteConversation(string, CancellationToken)

Mutes the conversation identified by id.

public Task<AtProtoHttpResult<ConversationView>> MuteConversation(string id, CancellationToken cancellationToken = default)

Parameters

id string

The conversation identifier to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when id is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

MuteModList(AtUri, CancellationToken)

Creates a mute relationship for the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteModList(AtUri, CancellationToken)

Creates a mute relationship for the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteModList(AtUri, CancellationToken)

Creates a mute relationship for the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to mute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteThread(AtUri, CancellationToken)

Mutes a thread preventing notifications from the thread and any of its children. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to mute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteThread(AtUri, CancellationToken)

Mutes a thread preventing notifications from the thread and any of its children. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to mute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

MuteThread(AtUri, CancellationToken)

Mutes a thread preventing notifications from the thread and any of its children. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> MuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to mute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Post(DraftWithId, bool, bool, PostInteractionSettingsPreferences?, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, bool extractFacets, bool deleteDraft, PostInteractionSettingsPreferences? interactionPreferences, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

extractFacets bool

Automatically extracts rich text facets from the draft post content.

deleteDraft bool

Flag indicating whether to delete the saved draft if posting it is successful.

interactionPreferences PostInteractionSettingsPreferences?

The current user's interaction preferences, if any.

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(string, string, DateTimeOffset?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, string langs, DateTimeOffset? createdAt = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

langs string

The languages the post was written in.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedImage, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedImage image, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

image EmbeddedImage

The image to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, ICollection<EmbeddedImage>?, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record. with multiple images.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, ICollection<EmbeddedImage>? images, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

images ICollection<EmbeddedImage>?

Any images to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Any thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Any post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

Any default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

if text length is greater than the maximum number of characters or graphemes, or images contains more than the maximum allowed number of images.

Post(string?, EmbeddedVideo, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with a video

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string? text, EmbeddedVideo video, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string?

The text of the post record to create.

video EmbeddedVideo

The video to embed in the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Any optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when video is null

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes, or threadGateRules contains more than the maximum allowed number of rules, or postGateRules contains more than the maximum allowed number of rules

Post(EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing just a external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

Posts containing an embedded card do not require post text.

Exceptions

ArgumentNullException

Thrown when externalCard is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, bool, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing text and an external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, bool extractFacets = true, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

extractFacets bool

Flag indicating whether facets should be extracted from text.

tags ICollection<string>?

Optional collection of tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when externalCard is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(Post, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, bool, CancellationToken)

Creates a post record from the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(Post post, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

post Post

The post to create the record from.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

extractFacets bool

Flag indicating whether facets should be extracted from the post text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(PostBuilder, CancellationToken)

Creates a Bluesky post record from the specified postBuilder.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(PostBuilder postBuilder, CancellationToken cancellationToken = default)

Parameters

postBuilder PostBuilder

The idunno.Bluesky.PostBuilder to use to create the record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postBuilder is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(DraftWithId, bool, bool, PostInteractionSettingsPreferences?, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, bool extractFacets, bool deleteDraft, PostInteractionSettingsPreferences? interactionPreferences, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

extractFacets bool

Automatically extracts rich text facets from the draft post content.

deleteDraft bool

Flag indicating whether to delete the saved draft if posting it is successful.

interactionPreferences PostInteractionSettingsPreferences?

The current user's interaction preferences, if any.

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(string, string, DateTimeOffset?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, string langs, DateTimeOffset? createdAt = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

langs string

The languages the post was written in.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedImage, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedImage image, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

image EmbeddedImage

The image to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, ICollection<EmbeddedImage>?, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record. with multiple images.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, ICollection<EmbeddedImage>? images, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

images ICollection<EmbeddedImage>?

Any images to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Any thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Any post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

Any default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

if text length is greater than the maximum number of characters or graphemes, or images contains more than the maximum allowed number of images.

Post(string?, EmbeddedVideo, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with a video

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string? text, EmbeddedVideo video, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string?

The text of the post record to create.

video EmbeddedVideo

The video to embed in the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Any optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when video is null

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes, or threadGateRules contains more than the maximum allowed number of rules, or postGateRules contains more than the maximum allowed number of rules

Post(EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing just a external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

Posts containing an embedded card do not require post text.

Exceptions

ArgumentNullException

Thrown when externalCard is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, bool, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing text and an external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, bool extractFacets = true, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

extractFacets bool

Flag indicating whether facets should be extracted from text.

tags ICollection<string>?

Optional collection of tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when externalCard is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(Post, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, bool, CancellationToken)

Creates a post record from the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(Post post, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

post Post

The post to create the record from.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

extractFacets bool

Flag indicating whether facets should be extracted from the post text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(PostBuilder, CancellationToken)

Creates a Bluesky post record from the specified postBuilder.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(PostBuilder postBuilder, CancellationToken cancellationToken = default)

Parameters

postBuilder PostBuilder

The idunno.Bluesky.PostBuilder to use to create the record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postBuilder is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(DraftWithId, bool, bool, PostInteractionSettingsPreferences?, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, bool extractFacets, bool deleteDraft, PostInteractionSettingsPreferences? interactionPreferences, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

extractFacets bool

Automatically extracts rich text facets from the draft post content.

deleteDraft bool

Flag indicating whether to delete the saved draft if posting it is successful.

interactionPreferences PostInteractionSettingsPreferences?

The current user's interaction preferences, if any.

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(DraftWithId, DraftMediaPathValidation, CancellationToken)

Creates a Bluesky post record from the specified draftWithId and deletes the draft if it is successfully posted.

public Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>> Post(DraftWithId draftWithId, DraftMediaPathValidation mediaPathValidation, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The idunno.Bluesky.Drafts.DraftWithId to use to create the post record(s).

mediaPathValidation DraftMediaPathValidation

Specifies how the local media paths in draftWithId are validated before the files they point to are read and uploaded.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<IReadOnlyList<CreateRecordResult>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when draftWithId or its Draft property is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

DraftException

Thrown when draftWithId cannot be converted to a post, or when one of its local media paths is rejected.

Post(string, string, DateTimeOffset?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, string langs, DateTimeOffset? createdAt = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

langs string

The languages the post was written in.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedImage, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedImage image, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

image EmbeddedImage

The image to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, ICollection<EmbeddedImage>?, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record. with multiple images.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, ICollection<EmbeddedImage>? images, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

images ICollection<EmbeddedImage>?

Any images to attach to the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Any thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Any post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

Any default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null, empty or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

if text length is greater than the maximum number of characters or graphemes, or images contains more than the maximum allowed number of images.

Post(string?, EmbeddedVideo, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, bool, CancellationToken)

Creates a Bluesky post record with a video

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string? text, EmbeddedVideo video, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

text string?

The text of the post record to create.

video EmbeddedVideo

The video to embed in the post.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Any optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

extractFacets bool

Flag indicating whether facets should be extracted from text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when video is null

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes, or threadGateRules contains more than the maximum allowed number of rules, or postGateRules contains more than the maximum allowed number of rules

Post(EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing just a external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

tags ICollection<string>?

Any optional tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

Posts containing an embedded card do not require post text.

Exceptions

ArgumentNullException

Thrown when externalCard is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(string, EmbeddedExternal, DateTimeOffset?, ICollection<string>?, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, PostSelfLabels?, bool, ICollection<string>?, CancellationToken)

Creates a Bluesky post record containing text and an external Open Graph embedded card.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(string text, EmbeddedExternal externalCard, DateTimeOffset? createdAt = null, ICollection<string>? langs = null, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, PostSelfLabels? labels = null, bool extractFacets = true, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

text string

The text of the post record to create.

externalCard EmbeddedExternal

An Open Graph embedded card.

createdAt DateTimeOffset?

The System.DateTimeOffset the post was created at.

langs ICollection<string>?

The languages the post was written in.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Post gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

labels PostSelfLabels?

Optional self label settings for the post media content.

extractFacets bool

Flag indicating whether facets should be extracted from text.

tags ICollection<string>?

Optional collection of tags to apply to the post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when externalCard is null, empty or whitespace.

ArgumentOutOfRangeException

Thrown when text length is greater than the maximum number of characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(Post, ICollection<ThreadGateRule>?, ICollection<PostGateRule>?, PostInteractionSettingsPreferences?, bool, CancellationToken)

Creates a post record from the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(Post post, ICollection<ThreadGateRule>? threadGateRules = null, ICollection<PostGateRule>? postGateRules = null, PostInteractionSettingsPreferences? interactionPreferences = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

post Post

The post to create the record from.

threadGateRules ICollection<ThreadGateRule>?

Thread gating rules to apply to the post, if any. Only valid if the post is a thread root.

postGateRules ICollection<PostGateRule>?

Gating rules to apply to the post, if any.

interactionPreferences PostInteractionSettingsPreferences?

The user's default interaction preferences. This will take effect if threadGateRules and/or postGateRules is null.

extractFacets bool

Flag indicating whether facets should be extracted from the post text.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Post(PostBuilder, CancellationToken)

Creates a Bluesky post record from the specified postBuilder.

public Task<AtProtoHttpResult<CreateRecordResult>> Post(PostBuilder postBuilder, CancellationToken cancellationToken = default)

Parameters

postBuilder PostBuilder

The idunno.Bluesky.PostBuilder to use to create the record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postBuilder is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

PutChatNotificationPreferences(Preferences)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences)

Parameters

preferences Preferences

The new chat notification preferences.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preferences, CancellationToken)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preference?, Preference?, CancellationToken)

Updates the authenticated user's preferences for chat notifications. Either chat, chatRequest, or both must be specified.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preference? chat = null, Preference? chatRequest = null, CancellationToken cancellationToken = default)

Parameters

chat Preference?

The new chat notification preferences.

chatRequest Preference?

The new chat request notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when both chat and chatRequest are null.

PutChatNotificationPreferences(Preferences)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences)

Parameters

preferences Preferences

The new chat notification preferences.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preferences, CancellationToken)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preference?, Preference?, CancellationToken)

Updates the authenticated user's preferences for chat notifications. Either chat, chatRequest, or both must be specified.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preference? chat = null, Preference? chatRequest = null, CancellationToken cancellationToken = default)

Parameters

chat Preference?

The new chat notification preferences.

chatRequest Preference?

The new chat request notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when both chat and chatRequest are null.

PutChatNotificationPreferences(Preferences)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences)

Parameters

preferences Preferences

The new chat notification preferences.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preferences, CancellationToken)

Updates the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

PutChatNotificationPreferences(Preference?, Preference?, CancellationToken)

Updates the authenticated user's preferences for chat notifications. Either chat, chatRequest, or both must be specified.

public Task<AtProtoHttpResult<Preferences>> PutChatNotificationPreferences(Preference? chat = null, Preference? chatRequest = null, CancellationToken cancellationToken = default)

Parameters

chat Preference?

The new chat notification preferences.

chatRequest Preference?

The new chat request notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentException

Thrown when both chat and chatRequest are null.

PutNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> PutNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

PutNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> PutNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

PutNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> PutNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

PutPreferences(IList<Preference>)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences)

Parameters

preferences IList<Preference>

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(IList<Preference>, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences, CancellationToken cancellationToken)

Parameters

preferences IList<Preference>

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences)

Parameters

preferences Preferences

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(IList<Preference>)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences)

Parameters

preferences IList<Preference>

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(IList<Preference>, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences, CancellationToken cancellationToken)

Parameters

preferences IList<Preference>

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences)

Parameters

preferences Preferences

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(IList<Preference>)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences)

Parameters

preferences IList<Preference>

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(IList<Preference>, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(IList<Preference> preferences, CancellationToken cancellationToken)

Parameters

preferences IList<Preference>

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences)

Parameters

preferences Preferences

The preferences to update

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

PutPreferences(Preferences, CancellationToken)

Updates the preferences for the current user, replacing them with the specified preferences.

public Task<AtProtoHttpResult<EmptyResponse>> PutPreferences(Preferences preferences, CancellationToken cancellationToken)

Parameters

preferences Preferences

The preferences to update

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

ArgumentOutOfRangeException

Thrown when preferences is empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

Quote(StrongReference, string, ICollection<string>?, CancellationToken)

Creates a post record, with the supplied text, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null.

ArgumentOutOfRangeException

Thrown when the text length is longer than the maximum permitted or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and image, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the post

image EmbeddedImage

The image to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null or tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and images, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<EmbeddedImage>? images, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post

images ICollection<EmbeddedImage>?

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null or text is null or empty.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference with just an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

image EmbeddedImage

The image to attach to the quote.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when image is null

ArgumentOutOfRangeException

Thrown when tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, ICollection<EmbeddedImage>? images = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

images ICollection<EmbeddedImage>?

Any images to attach to the quote post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null

ArgumentOutOfRangeException

Thrown when images has too many images, or tags has too many tags, or a tag that exceeds the maximum length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

InvalidOperationException

Thrown when the ApplyWrites() result is not as expected.

Quote(StrongReference, string, ICollection<string>?, CancellationToken)

Creates a post record, with the supplied text, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null.

ArgumentOutOfRangeException

Thrown when the text length is longer than the maximum permitted or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and image, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the post

image EmbeddedImage

The image to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null or tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and images, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<EmbeddedImage>? images, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post

images ICollection<EmbeddedImage>?

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null or text is null or empty.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference with just an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

image EmbeddedImage

The image to attach to the quote.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when image is null

ArgumentOutOfRangeException

Thrown when tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, ICollection<EmbeddedImage>? images = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

images ICollection<EmbeddedImage>?

Any images to attach to the quote post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null

ArgumentOutOfRangeException

Thrown when images has too many images, or tags has too many tags, or a tag that exceeds the maximum length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

InvalidOperationException

Thrown when the ApplyWrites() result is not as expected.

Quote(StrongReference, string, ICollection<string>?, CancellationToken)

Creates a post record, with the supplied text, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null.

ArgumentOutOfRangeException

Thrown when the text length is longer than the maximum permitted or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and image, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the post

image EmbeddedImage

The image to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when text is null or tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, string, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates a simple Bluesky post record with the specified text, if any, and images, quoting the post identified by idunno.AtProto.Repo.StrongReference.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, string text, ICollection<EmbeddedImage>? images, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

text string

The text for the new post

images ICollection<EmbeddedImage>?

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null or text is null or empty.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, EmbeddedImage, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference with just an image.

public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, EmbeddedImage image, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

image EmbeddedImage

The image to attach to the quote.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when image is null

ArgumentOutOfRangeException

Thrown when tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Quote(StrongReference, ICollection<EmbeddedImage>?, ICollection<string>?, CancellationToken)

Creates an Bluesky post record quoting the post identified by idunno.AtProto.Repo.StrongReference.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to ApplyWrites().")]
public Task<AtProtoHttpResult<CreateRecordResult>> Quote(StrongReference strongReference, ICollection<EmbeddedImage>? images = null, ICollection<string>? tags = null, CancellationToken cancellationToken = default)

Parameters

strongReference StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be quoted.

images ICollection<EmbeddedImage>?

Any images to attach to the quote post.

tags ICollection<string>?

Any tags to apply to the quote post.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when strongReference is null

ArgumentOutOfRangeException

Thrown when images has too many images, or tags has too many tags, or a tag that exceeds the maximum length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

InvalidOperationException

Thrown when the ApplyWrites() result is not as expected.

RejectJoinGroupRequest(string, Did, CancellationToken)

Rejects a request to join a group (via join link) the user owns.

public Task<AtProtoHttpResult<EmptyResponse>> RejectJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to reject the join request for.

member Did

The idunno.AtProto.Did of the user to reject the join request for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or member is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RejectJoinGroupRequest(string, Did, CancellationToken)

Rejects a request to join a group (via join link) the user owns.

public Task<AtProtoHttpResult<EmptyResponse>> RejectJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to reject the join request for.

member Did

The idunno.AtProto.Did of the user to reject the join request for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or member is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RejectJoinGroupRequest(string, Did, CancellationToken)

Rejects a request to join a group (via join link) the user owns.

public Task<AtProtoHttpResult<EmptyResponse>> RejectJoinGroupRequest(string conversationId, Did member, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to reject the join request for.

member Did

The idunno.AtProto.Did of the user to reject the join request for.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or member is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RemoveGroupMembers(string, ICollection<Did>, CancellationToken)

Removes the specified members from the conversation identified by conversationId.

public Task<AtProtoHttpResult<RemoveMembersResponse>> RemoveGroupMembers(string conversationId, ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to remove members from.

members ICollection<Did>

The System.Collections.Generic.ICollection`1 of users to remove from the group.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RemoveMembersResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or members is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RemoveGroupMembers(string, ICollection<Did>, CancellationToken)

Removes the specified members from the conversation identified by conversationId.

public Task<AtProtoHttpResult<RemoveMembersResponse>> RemoveGroupMembers(string conversationId, ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to remove members from.

members ICollection<Did>

The System.Collections.Generic.ICollection`1 of users to remove from the group.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RemoveMembersResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or members is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RemoveGroupMembers(string, ICollection<Did>, CancellationToken)

Removes the specified members from the conversation identified by conversationId.

public Task<AtProtoHttpResult<RemoveMembersResponse>> RemoveGroupMembers(string conversationId, ICollection<Did> members, CancellationToken cancellationToken = default)

Parameters

conversationId string

The id of the group to remove members from.

members ICollection<Did>

The System.Collections.Generic.ICollection`1 of users to remove from the group.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RemoveMembersResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when conversationId or members is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RemoveReaction(string, string, string, CancellationToken)

Removes a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> RemoveReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId, messageId or value is whitespace.

ArgumentNullException

Thrown when conversationId, messageId or value is null.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

RemoveReaction(string, string, string, CancellationToken)

Removes a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> RemoveReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId, messageId or value is whitespace.

ArgumentNullException

Thrown when conversationId, messageId or value is null.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

RemoveReaction(string, string, string, CancellationToken)

Removes a reaction to the message identified by messageId from the conversation identified by conversationId for the authenticated user.

public Task<AtProtoHttpResult<MessageView>> RemoveReaction(string conversationId, string messageId, string value, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to add the reaction to identified by messageId from.

messageId string

The message identifier to add the reaction to from conversationId.

value string

The reaction to add.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId, messageId or value is whitespace.

ArgumentNullException

Thrown when conversationId, messageId or value is null.

ArgumentOutOfRangeException

Thrown when value has a grapheme length that does not equal 1.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when parent or text is nul.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes.

ReplyTo(StrongReference, string, EmbeddedImage, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, EmbeddedImage image, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply

image EmbeddedImage

An image to attach to the reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when parent, text or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<EmbeddedImage>, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<EmbeddedImage> images, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new post

images ICollection<EmbeddedImage>

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown text is null or empty, or tags contains a null or empty tag.

ArgumentNullException

Thrown when parent is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when parent or text is nul.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes.

ReplyTo(StrongReference, string, EmbeddedImage, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, EmbeddedImage image, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply

image EmbeddedImage

An image to attach to the reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when parent, text or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<EmbeddedImage>, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<EmbeddedImage> images, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new post

images ICollection<EmbeddedImage>

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown text is null or empty, or tags contains a null or empty tag.

ArgumentNullException

Thrown when parent is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when parent or text is nul.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes.

ReplyTo(StrongReference, string, EmbeddedImage, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text, in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, EmbeddedImage image, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new reply

image EmbeddedImage

An image to attach to the reply.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when tags contains a null or empty tag.

ArgumentNullException

Thrown when parent, text or image is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ReplyTo(StrongReference, string, ICollection<EmbeddedImage>, ICollection<string>?, bool, CancellationToken)

Creates a simple Bluesky post record with the specified text in reply to the parent post.

public Task<AtProtoHttpResult<CreateRecordResult>> ReplyTo(StrongReference parent, string text, ICollection<EmbeddedImage> images, ICollection<string>? tags = null, bool extractFacets = true, CancellationToken cancellationToken = default)

Parameters

parent StrongReference

A idunno.AtProto.Repo.StrongReference to the parent post that the new post will be in reply to.

text string

The text for the new post

images ICollection<EmbeddedImage>

Any images to attach to the post.

tags ICollection<string>?

Any tags to apply to the reply.

extractFacets bool

Flag indicating whether facets should be extracted from the post text automatically.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown text is null or empty, or tags contains a null or empty tag.

ArgumentNullException

Thrown when parent is null.

ArgumentOutOfRangeException

Thrown when text's length is greater than the maximum allowed characters or graphemes, or tags contains a tag whose length is greater than the maximum allowed characters or graphemes.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Repost(StrongReference, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(StrongReference post, CancellationToken cancellationToken = default)

Parameters

post StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when the post does not point to a Bluesky feed post record.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Repost(AtUri, Cid, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be reposted.

cid Cid

The idunno.AtProto.Cid of the record to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(PostView, CancellationToken)

Creates a repost record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, its Uri property, or the its Uri Collection value is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(FeedViewPost, CancellationToken)

Creates a repost record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property is null, or its idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(StrongReference, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(StrongReference post, CancellationToken cancellationToken = default)

Parameters

post StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when the post does not point to a Bluesky feed post record.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Repost(AtUri, Cid, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be reposted.

cid Cid

The idunno.AtProto.Cid of the record to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(PostView, CancellationToken)

Creates a repost record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, its Uri property, or the its Uri Collection value is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(FeedViewPost, CancellationToken)

Creates a repost record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property is null, or its idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(StrongReference, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(StrongReference post, CancellationToken cancellationToken = default)

Parameters

post StrongReference

A idunno.AtProto.Repo.StrongReference to the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when post is null.

ArgumentException

Thrown when the post does not point to a Bluesky feed post record.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Repost(AtUri, Cid, CancellationToken)

Creates a repost record in the current user's repo for the post referred to by the specified uri and cid.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(AtUri uri, Cid cid, CancellationToken cancellationToken = default)

Parameters

uri AtUri

An idunno.AtProto.AtUri to the record to be reposted.

cid Cid

The idunno.AtProto.Cid of the record to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Remarks

You should prefer to use idunno.Bluesky.BlueskyAgent.Repost(idunno.Bluesky.Feed.FeedViewPost,System.Threading.CancellationToken) as this will ensure reposts of reposts create the right notifications.

Exceptions

ArgumentNullException

Thrown when uri, the uri collection, or cid is null.

ArgumentOutOfRangeException

Thrown when the uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(PostView, CancellationToken)

Creates a repost record in the current user's repo for the specified in the postView.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(PostView postView, CancellationToken cancellationToken = default)

Parameters

postView PostView

A idunno.Bluesky.Feed.PostView of the post to be liked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postView, its Uri property, or the its Uri Collection value is null.

ArgumentOutOfRangeException

Thrown when the postView Uri does not point to a post.

AuthenticationRequiredException

if the agent is not authenticated.

Repost(FeedViewPost, CancellationToken)

Creates a repost record in the current user's repo for the specified post.

public Task<AtProtoHttpResult<CreateRecordResult>> Repost(FeedViewPost post, CancellationToken cancellationToken = default)

Parameters

post FeedViewPost

A idunno.Bluesky.Feed.FeedViewPost of the post to be reposted.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when post, or its idunno.Bluesky.Feed.FeedViewPost.Post property is null, or its idunno.Bluesky.Feed.PostView.Uri collection is null.

ArgumentOutOfRangeException

Thrown when the idunno.Bluesky.Feed.FeedViewPost.Post property on post does not point to a post, or. if a reason is present and the reason is typeof idunno.Bluesky.Feed.ReasonRepost and reason idunno.AtProto.Repo.StrongReference is null, or the strong reference's Uri property is null, or the strong reference's URI does not point to a Repost record.

AuthenticationRequiredException

if the agent is not authenticated.

RequestJoinGroup(string, CancellationToken)

Sends a request to join a group (via join link) to the group owner.

public Task<AtProtoHttpResult<RequestJoinResponse>> RequestJoinGroup(string code, CancellationToken cancellationToken = default)

Parameters

code string

The code from a join link.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RequestJoinResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when code is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RequestJoinGroup(string, CancellationToken)

Sends a request to join a group (via join link) to the group owner.

public Task<AtProtoHttpResult<RequestJoinResponse>> RequestJoinGroup(string code, CancellationToken cancellationToken = default)

Parameters

code string

The code from a join link.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RequestJoinResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when code is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

RequestJoinGroup(string, CancellationToken)

Sends a request to join a group (via join link) to the group owner.

public Task<AtProtoHttpResult<RequestJoinResponse>> RequestJoinGroup(string code, CancellationToken cancellationToken = default)

Parameters

code string

The code from a join link.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<RequestJoinResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when code is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SearchActors(string, int?, string?, IEnumerable<Did>?, CancellationToken)

Find actors (profiles) matching search criteria. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> SearchActors(string q, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

The search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchActors(string, int?, string?, IEnumerable<Did>?, CancellationToken)

Find actors (profiles) matching search criteria. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> SearchActors(string q, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

The search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchActors(string, int?, string?, IEnumerable<Did>?, CancellationToken)

Find actors (profiles) matching search criteria. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>> SearchActors(string q, int? limit = 50, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

The search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchActorsTypeahead(string, int?, IEnumerable<Did>?, CancellationToken)

Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> SearchActorsTypeahead(string q, int? limit = 10, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query prefix; not a full query string.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchActorsTypeahead(string, int?, IEnumerable<Did>?, CancellationToken)

Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> SearchActorsTypeahead(string q, int? limit = 10, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query prefix; not a full query string.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchActorsTypeahead(string, int?, IEnumerable<Did>?, CancellationToken)

Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require authentication.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>> SearchActorsTypeahead(string q, int? limit = 10, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query prefix; not a full query string.

limit int?

The number of suggested actors to return. Defaults to 50 if null.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the account.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<ProfileViewBasic>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when q is null or empty.

ArgumentOutOfRangeException

Thrown when limit is <=0 or >100.

SearchPosts(string, SearchOrder?, string?, string?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, SearchOrder? searchOrder = null, string? since = null, string? until = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

searchOrder SearchOrder?

Specifies the ranking order of results.

since string?

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).

until string?

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is null or whitespace

SearchPosts(string, DateTimeOffset, DateTimeOffset, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateTimeOffset since, DateTimeOffset until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateTimeOffset

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateTimeOffset

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is whitespace

ArgumentNullException

Thrown when query is null

SearchPosts(string, DateOnly, DateOnly, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateOnly since, DateOnly until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateOnly

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateOnly

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when query is null.

ArgumentException

Thrown when query is whitespace.

SearchPosts(string, SearchOrder?, string?, string?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, SearchOrder? searchOrder = null, string? since = null, string? until = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

searchOrder SearchOrder?

Specifies the ranking order of results.

since string?

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).

until string?

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is null or whitespace

SearchPosts(string, DateTimeOffset, DateTimeOffset, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateTimeOffset since, DateTimeOffset until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateTimeOffset

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateTimeOffset

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is whitespace

ArgumentNullException

Thrown when query is null

SearchPosts(string, DateOnly, DateOnly, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateOnly since, DateOnly until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateOnly

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateOnly

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when query is null.

ArgumentException

Thrown when query is whitespace.

SearchPosts(string, SearchOrder?, string?, string?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, SearchOrder? searchOrder = null, string? since = null, string? until = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

searchOrder SearchOrder?

Specifies the ranking order of results.

since string?

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).

until string?

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is null or whitespace

SearchPosts(string, DateTimeOffset, DateTimeOffset, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateTimeOffset since, DateTimeOffset until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateTimeOffset

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateTimeOffset

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when query is whitespace

ArgumentNullException

Thrown when query is null

SearchPosts(string, DateOnly, DateOnly, SearchOrder?, AtIdentifier?, AtIdentifier?, string?, string?, Uri?, ICollection<string>?, int?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching search criteria, returning views of those posts

public Task<AtProtoHttpResult<SearchResults>> SearchPosts(string query, DateOnly since, DateOnly until, SearchOrder? searchOrder = null, AtIdentifier? mentions = null, AtIdentifier? author = null, string? lang = null, string? domain = null, Uri? url = null, ICollection<string>? tags = null, int? limit = null, string? cursor = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

query string

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since DateOnly

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

until DateOnly

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'.

searchOrder SearchOrder?

Specifies the ranking order of results.

mentions AtIdentifier?

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author AtIdentifier?

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang string?

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string?

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url Uri?

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tags ICollection<string>?

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix.

limit int?

The maximum number of post views to return

cursor string?

An optional cursor for pagination.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchResults>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when query is null.

ArgumentException

Thrown when query is whitespace.

SearchPostsV2(string?, int?, string?, SortOrder?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, DateTimeOffset?, DateTimeOffset?, bool?, ICollection<string>?, ICollection<string>?, bool?, bool?, AtUri?, AtUri?, bool?, bool?, bool?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching a search query or filters, returning search hits for matching post records.

public Task<AtProtoHttpResult<SearchV2Results>> SearchPostsV2(string? cursor = null, int? limit = null, string? query = null, SortOrder? sort = null, ICollection<AtIdentifier>? authors = null, ICollection<AtIdentifier>? mentions = null, ICollection<string>? domains = null, ICollection<Uri>? urls = null, ICollection<AtUri>? embeddedAtUris = null, ICollection<string>? hashTags = null, ICollection<AtIdentifier>? excludeAuthors = null, ICollection<AtIdentifier>? excludeMentions = null, ICollection<string>? excludeDomains = null, ICollection<Uri>? excludeUrls = null, ICollection<AtUri>? excludeEmbeddedAtUris = null, ICollection<string>? excludeHashTags = null, DateTimeOffset? since = null, DateTimeOffset? until = null, bool? allTime = null, ICollection<string>? languages = null, ICollection<string>? excludeLanguages = null, bool? hasMedia = null, bool? hasVideo = null, AtUri? replyParentUri = null, AtUri? threadRootUri = null, bool? excludeReplies = null, bool? repliesOnly = null, bool? following = null, string? queryLanguage = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

Optional pagination cursor.

limit int?

Optional maximum number of results to return.

query string?

Search query string. A query or at least one filter is required.

sort SortOrder?

Ranking order for results. 'recent' sorts by recency; 'top' uses search ranking.

authors ICollection<AtIdentifier>?

If provided, include posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

mentions ICollection<AtIdentifier>?

If provided, include posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

domains ICollection<string>?

If provided, include posts that link to any of these domains.

urls ICollection<Uri>?

If provided, include posts with links pointing to any of these System.Uri.

embeddedAtUris ICollection<AtUri>?

If provided, include posts with embed any of the provided idunno.AtProto.AtUri.

hashTags ICollection<string>?

If provided, include posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

excludeAuthors ICollection<AtIdentifier>?

If provided, exclude posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeMentions ICollection<AtIdentifier>?

If provided, exclude posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeDomains ICollection<string>?

If provided, exclude posts that link to any of these domains.

excludeUrls ICollection<Uri>?

If provided, exclude posts with links pointing to any of these System.Uri.

excludeEmbeddedAtUris ICollection<AtUri>?

If provided, exclude posts with embed any of the provided idunno.AtProto.AtUri.

excludeHashTags ICollection<string>?

If provided, exclude posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

since DateTimeOffset?

If provided, include posts indexed at or after this timestamp.

until DateTimeOffset?

If provided, include posts indexed before this timestamp.

allTime bool?

Optional flag indicating whether to search the full index instead of the recent-post window.

languages ICollection<string>?

If provided, include posts whose language matches any of these language codes.

excludeLanguages ICollection<string>?

If provided, exclude posts whose language matches any of these language codes.

hasMedia bool?

Optional flag indicating whether to only include posts with media.

hasVideo bool?

Optional flag indicating whether to only include posts with video.

replyParentUri AtUri?

If provided, Include only direct replies to this parent post idunno.AtProto.AtUri.

threadRootUri AtUri?

If provided, include only posts in the thread rooted at this post idunno.AtProto.AtUri.

excludeReplies bool?

Optional flag indicating whether to exclude replies from results. Mutually exclusive with repliesOnly.

repliesOnly bool?

Optional flag indicating whether to include only replies in results. Mutually exclusive with excludeReplies.

following bool?

Optional flag indicating whether to include only posts from accounts followed by the viewer.

queryLanguage string?

Optional Language analyzer hint for the query text. If unset, the server auto-detects when possible.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchV2Results>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when both repliesOnly and excludeReplies are set.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SearchPostsV2(string?, int?, string?, SortOrder?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, DateTimeOffset?, DateTimeOffset?, bool?, ICollection<string>?, ICollection<string>?, bool?, bool?, AtUri?, AtUri?, bool?, bool?, bool?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching a search query or filters, returning search hits for matching post records.

public Task<AtProtoHttpResult<SearchV2Results>> SearchPostsV2(string? cursor = null, int? limit = null, string? query = null, SortOrder? sort = null, ICollection<AtIdentifier>? authors = null, ICollection<AtIdentifier>? mentions = null, ICollection<string>? domains = null, ICollection<Uri>? urls = null, ICollection<AtUri>? embeddedAtUris = null, ICollection<string>? hashTags = null, ICollection<AtIdentifier>? excludeAuthors = null, ICollection<AtIdentifier>? excludeMentions = null, ICollection<string>? excludeDomains = null, ICollection<Uri>? excludeUrls = null, ICollection<AtUri>? excludeEmbeddedAtUris = null, ICollection<string>? excludeHashTags = null, DateTimeOffset? since = null, DateTimeOffset? until = null, bool? allTime = null, ICollection<string>? languages = null, ICollection<string>? excludeLanguages = null, bool? hasMedia = null, bool? hasVideo = null, AtUri? replyParentUri = null, AtUri? threadRootUri = null, bool? excludeReplies = null, bool? repliesOnly = null, bool? following = null, string? queryLanguage = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

Optional pagination cursor.

limit int?

Optional maximum number of results to return.

query string?

Search query string. A query or at least one filter is required.

sort SortOrder?

Ranking order for results. 'recent' sorts by recency; 'top' uses search ranking.

authors ICollection<AtIdentifier>?

If provided, include posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

mentions ICollection<AtIdentifier>?

If provided, include posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

domains ICollection<string>?

If provided, include posts that link to any of these domains.

urls ICollection<Uri>?

If provided, include posts with links pointing to any of these System.Uri.

embeddedAtUris ICollection<AtUri>?

If provided, include posts with embed any of the provided idunno.AtProto.AtUri.

hashTags ICollection<string>?

If provided, include posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

excludeAuthors ICollection<AtIdentifier>?

If provided, exclude posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeMentions ICollection<AtIdentifier>?

If provided, exclude posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeDomains ICollection<string>?

If provided, exclude posts that link to any of these domains.

excludeUrls ICollection<Uri>?

If provided, exclude posts with links pointing to any of these System.Uri.

excludeEmbeddedAtUris ICollection<AtUri>?

If provided, exclude posts with embed any of the provided idunno.AtProto.AtUri.

excludeHashTags ICollection<string>?

If provided, exclude posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

since DateTimeOffset?

If provided, include posts indexed at or after this timestamp.

until DateTimeOffset?

If provided, include posts indexed before this timestamp.

allTime bool?

Optional flag indicating whether to search the full index instead of the recent-post window.

languages ICollection<string>?

If provided, include posts whose language matches any of these language codes.

excludeLanguages ICollection<string>?

If provided, exclude posts whose language matches any of these language codes.

hasMedia bool?

Optional flag indicating whether to only include posts with media.

hasVideo bool?

Optional flag indicating whether to only include posts with video.

replyParentUri AtUri?

If provided, Include only direct replies to this parent post idunno.AtProto.AtUri.

threadRootUri AtUri?

If provided, include only posts in the thread rooted at this post idunno.AtProto.AtUri.

excludeReplies bool?

Optional flag indicating whether to exclude replies from results. Mutually exclusive with repliesOnly.

repliesOnly bool?

Optional flag indicating whether to include only replies in results. Mutually exclusive with excludeReplies.

following bool?

Optional flag indicating whether to include only posts from accounts followed by the viewer.

queryLanguage string?

Optional Language analyzer hint for the query text. If unset, the server auto-detects when possible.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchV2Results>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when both repliesOnly and excludeReplies are set.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SearchPostsV2(string?, int?, string?, SortOrder?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, ICollection<AtIdentifier>?, ICollection<AtIdentifier>?, ICollection<string>?, ICollection<Uri>?, ICollection<AtUri>?, ICollection<string>?, DateTimeOffset?, DateTimeOffset?, bool?, ICollection<string>?, ICollection<string>?, bool?, bool?, AtUri?, AtUri?, bool?, bool?, bool?, string?, IEnumerable<Did>?, CancellationToken)

Find posts matching a search query or filters, returning search hits for matching post records.

public Task<AtProtoHttpResult<SearchV2Results>> SearchPostsV2(string? cursor = null, int? limit = null, string? query = null, SortOrder? sort = null, ICollection<AtIdentifier>? authors = null, ICollection<AtIdentifier>? mentions = null, ICollection<string>? domains = null, ICollection<Uri>? urls = null, ICollection<AtUri>? embeddedAtUris = null, ICollection<string>? hashTags = null, ICollection<AtIdentifier>? excludeAuthors = null, ICollection<AtIdentifier>? excludeMentions = null, ICollection<string>? excludeDomains = null, ICollection<Uri>? excludeUrls = null, ICollection<AtUri>? excludeEmbeddedAtUris = null, ICollection<string>? excludeHashTags = null, DateTimeOffset? since = null, DateTimeOffset? until = null, bool? allTime = null, ICollection<string>? languages = null, ICollection<string>? excludeLanguages = null, bool? hasMedia = null, bool? hasVideo = null, AtUri? replyParentUri = null, AtUri? threadRootUri = null, bool? excludeReplies = null, bool? repliesOnly = null, bool? following = null, string? queryLanguage = null, IEnumerable<Did>? subscribedLabelers = null, CancellationToken cancellationToken = default)

Parameters

cursor string?

Optional pagination cursor.

limit int?

Optional maximum number of results to return.

query string?

Search query string. A query or at least one filter is required.

sort SortOrder?

Ranking order for results. 'recent' sorts by recency; 'top' uses search ranking.

authors ICollection<AtIdentifier>?

If provided, include posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

mentions ICollection<AtIdentifier>?

If provided, include posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

domains ICollection<string>?

If provided, include posts that link to any of these domains.

urls ICollection<Uri>?

If provided, include posts with links pointing to any of these System.Uri.

embeddedAtUris ICollection<AtUri>?

If provided, include posts with embed any of the provided idunno.AtProto.AtUri.

hashTags ICollection<string>?

If provided, include posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

excludeAuthors ICollection<AtIdentifier>?

If provided, exclude posts by any of these authors. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeMentions ICollection<AtIdentifier>?

If provided, exclude posts that mention any of these accounts. idunno.AtProto.Handles are resolved to DIDs before searching.

excludeDomains ICollection<string>?

If provided, exclude posts that link to any of these domains.

excludeUrls ICollection<Uri>?

If provided, exclude posts with links pointing to any of these System.Uri.

excludeEmbeddedAtUris ICollection<AtUri>?

If provided, exclude posts with embed any of the provided idunno.AtProto.AtUri.

excludeHashTags ICollection<string>?

If provided, exclude posts with tagged with any of these hashtags. Do not include the hash (#) prefix.

since DateTimeOffset?

If provided, include posts indexed at or after this timestamp.

until DateTimeOffset?

If provided, include posts indexed before this timestamp.

allTime bool?

Optional flag indicating whether to search the full index instead of the recent-post window.

languages ICollection<string>?

If provided, include posts whose language matches any of these language codes.

excludeLanguages ICollection<string>?

If provided, exclude posts whose language matches any of these language codes.

hasMedia bool?

Optional flag indicating whether to only include posts with media.

hasVideo bool?

Optional flag indicating whether to only include posts with video.

replyParentUri AtUri?

If provided, Include only direct replies to this parent post idunno.AtProto.AtUri.

threadRootUri AtUri?

If provided, include only posts in the thread rooted at this post idunno.AtProto.AtUri.

excludeReplies bool?

Optional flag indicating whether to exclude replies from results. Mutually exclusive with repliesOnly.

repliesOnly bool?

Optional flag indicating whether to include only replies in results. Mutually exclusive with excludeReplies.

following bool?

Optional flag indicating whether to include only posts from accounts followed by the viewer.

queryLanguage string?

Optional Language analyzer hint for the query text. If unset, the server auto-detects when possible.

subscribedLabelers IEnumerable<Did>?

An optional list of idunno.AtProto.Dids of labelers to retrieve labels applied to the post view.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchV2Results>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when both repliesOnly and excludeReplies are set.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SearchStarterPacks(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> SearchStarterPacks(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SearchStarterPacks(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> SearchStarterPacks(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SearchStarterPacks(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>> SearchStarterPacks(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be return in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PagedViewReadOnlyCollection<StarterPackViewBasic>>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SearchStarterPacksV2(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<SearchStarterPacksV2Result>> SearchStarterPacksV2(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be returned in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchStarterPacksV2Result>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SearchStarterPacksV2(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<SearchStarterPacksV2Result>> SearchStarterPacksV2(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be returned in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchStarterPacksV2Result>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SearchStarterPacksV2(string, int?, string?, CancellationToken)

Find starter packs matching search criteria.

public Task<AtProtoHttpResult<SearchStarterPacksV2Result>> SearchStarterPacksV2(string q, int? limit = null, string? cursor = null, CancellationToken cancellationToken = default)

Parameters

q string

Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended

limit int?

The maximum number of lists that should be returned in a page.

cursor string?

An optional cursor for pagination.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SearchStarterPacksV2Result>>

The task object representing the asynchronous operation.

Remarks

The XRPC endpoint for searching starter packs currently returns a 404.

Exceptions

ArgumentNullException

Thrown when q is null.

ArgumentOutOfRangeException

Thrown when limit is less than 1 or greater than 100.

AuthenticationRequiredException

Thrown when the user is not authenticated.

SendMessage(string, string, bool, StrongReference?, ReplyReference?, CancellationToken)

Sends the specified idunno.Bluesky.Chat.MessageInput to the conversation identified by conversationId.

public Task<AtProtoHttpResult<MessageView>> SendMessage(string conversationId, string message, bool extractFacets = true, StrongReference? embeddedPost = null, ReplyReference? replyTo = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to send the message to.

message string

The message to send.

extractFacets bool

Flag indicating whether facets should be extracted from message.

embeddedPost StrongReference?

A idunno.AtProto.Repo.StrongReference to a post that will be embedded in the message.

replyTo ReplyReference?

A idunno.Bluesky.Chat.ReplyReference to a message in the same conversation that this message is replying to.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

ArgumentNullException

Thrown when message is null, or if embeddedPost is specified but its collection is null.

ArgumentOutOfRangeException

Thrown when message is longer than the maximum allowed length, or when embeddedPost is specified but it is not in the idunno.Bluesky.CollectionNsid.Post collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SendMessage(string, string, bool, StrongReference?, ReplyReference?, CancellationToken)

Sends the specified idunno.Bluesky.Chat.MessageInput to the conversation identified by conversationId.

public Task<AtProtoHttpResult<MessageView>> SendMessage(string conversationId, string message, bool extractFacets = true, StrongReference? embeddedPost = null, ReplyReference? replyTo = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to send the message to.

message string

The message to send.

extractFacets bool

Flag indicating whether facets should be extracted from message.

embeddedPost StrongReference?

A idunno.AtProto.Repo.StrongReference to a post that will be embedded in the message.

replyTo ReplyReference?

A idunno.Bluesky.Chat.ReplyReference to a message in the same conversation that this message is replying to.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

ArgumentNullException

Thrown when message is null, or if embeddedPost is specified but its collection is null.

ArgumentOutOfRangeException

Thrown when message is longer than the maximum allowed length, or when embeddedPost is specified but it is not in the idunno.Bluesky.CollectionNsid.Post collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SendMessage(string, string, bool, StrongReference?, ReplyReference?, CancellationToken)

Sends the specified idunno.Bluesky.Chat.MessageInput to the conversation identified by conversationId.

public Task<AtProtoHttpResult<MessageView>> SendMessage(string conversationId, string message, bool extractFacets = true, StrongReference? embeddedPost = null, ReplyReference? replyTo = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to send the message to.

message string

The message to send.

extractFacets bool

Flag indicating whether facets should be extracted from message.

embeddedPost StrongReference?

A idunno.AtProto.Repo.StrongReference to a post that will be embedded in the message.

replyTo ReplyReference?

A idunno.Bluesky.Chat.ReplyReference to a message in the same conversation that this message is replying to.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<MessageView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

ArgumentNullException

Thrown when message is null, or if embeddedPost is specified but its collection is null.

ArgumentOutOfRangeException

Thrown when message is longer than the maximum allowed length, or when embeddedPost is specified but it is not in the idunno.Bluesky.CollectionNsid.Post collection.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SendMessageBatch(ICollection<BatchedMessage>, CancellationToken)

Sends the specified batchedMessages.

public Task<AtProtoHttpResult<ICollection<MessageView>>> SendMessageBatch(ICollection<BatchedMessage> batchedMessages, CancellationToken cancellationToken = default)

Parameters

batchedMessages ICollection<BatchedMessage>

The collection of idunno.Bluesky.Chat.BatchedMessages to send.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<MessageView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when batchedMessages is null.

ArgumentOutOfRangeException

Thrown when batchedMessages is empty or has greater than the maximum allowed number of messages.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SendMessageBatch(ICollection<BatchedMessage>, CancellationToken)

Sends the specified batchedMessages.

public Task<AtProtoHttpResult<ICollection<MessageView>>> SendMessageBatch(ICollection<BatchedMessage> batchedMessages, CancellationToken cancellationToken = default)

Parameters

batchedMessages ICollection<BatchedMessage>

The collection of idunno.Bluesky.Chat.BatchedMessages to send.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<MessageView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when batchedMessages is null.

ArgumentOutOfRangeException

Thrown when batchedMessages is empty or has greater than the maximum allowed number of messages.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SendMessageBatch(ICollection<BatchedMessage>, CancellationToken)

Sends the specified batchedMessages.

public Task<AtProtoHttpResult<ICollection<MessageView>>> SendMessageBatch(ICollection<BatchedMessage> batchedMessages, CancellationToken cancellationToken = default)

Parameters

batchedMessages ICollection<BatchedMessage>

The collection of idunno.Bluesky.Chat.BatchedMessages to send.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ICollection<MessageView>>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when batchedMessages is null.

ArgumentOutOfRangeException

Thrown when batchedMessages is empty or has greater than the maximum allowed number of messages.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetActivitySubscription(Did, bool, bool, CancellationToken)

Sets the activity notification settings for the specified subject. Requires authentication.

public Task<AtProtoHttpResult<SubjectActivitySubscription>> SetActivitySubscription(Did subject, bool posts, bool replies, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the actor for whom activity notifications should be set.

posts bool

Flag indicating whether notifications should be enabled for posts.

replies bool

Flag indicating whether notifications should be enabled for replies. posts must also be true for this setting to work.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SubjectActivitySubscription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentException

Thrown when replies is true but posts is false.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetActivitySubscription(Did, bool, bool, CancellationToken)

Sets the activity notification settings for the specified subject. Requires authentication.

public Task<AtProtoHttpResult<SubjectActivitySubscription>> SetActivitySubscription(Did subject, bool posts, bool replies, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the actor for whom activity notifications should be set.

posts bool

Flag indicating whether notifications should be enabled for posts.

replies bool

Flag indicating whether notifications should be enabled for replies. posts must also be true for this setting to work.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SubjectActivitySubscription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentException

Thrown when replies is true but posts is false.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetActivitySubscription(Did, bool, bool, CancellationToken)

Sets the activity notification settings for the specified subject. Requires authentication.

public Task<AtProtoHttpResult<SubjectActivitySubscription>> SetActivitySubscription(Did subject, bool posts, bool replies, CancellationToken cancellationToken = default)

Parameters

subject Did

The idunno.AtProto.Did of the actor for whom activity notifications should be set.

posts bool

Flag indicating whether notifications should be enabled for posts.

replies bool

Flag indicating whether notifications should be enabled for replies. posts must also be true for this setting to work.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<SubjectActivitySubscription>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when subject is null.

ArgumentException

Thrown when replies is true but posts is false.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetChatNotificationPreferences(Preferences, CancellationToken)

Sets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> SetChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

SetChatNotificationPreferences(Preferences, CancellationToken)

Sets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> SetChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

SetChatNotificationPreferences(Preferences, CancellationToken)

Sets the authenticated user's preferences for chat notifications.

public Task<AtProtoHttpResult<Preferences>> SetChatNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The new chat notification preferences.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

ArgumentNullException

Thrown when preferences is null.

SetContentVisibilityDeclaration(bool, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations, CancellationToken cancellationToken)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(bool)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration, CancellationToken cancellationToken)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration, CancellationToken cancellationToken)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(bool, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations, CancellationToken cancellationToken)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(bool)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration, CancellationToken cancellationToken)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration, CancellationToken cancellationToken)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(bool, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations, CancellationToken cancellationToken)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(bool)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(bool hideFromAlgorithmicRecommendations)

Parameters

hideFromAlgorithmicRecommendations bool

Flag indicating whether the account requests that its posts be hidden from algorithmic recommendations.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration, CancellationToken cancellationToken)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(ContentVisibilityDeclaration)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(ContentVisibilityDeclaration declaration)

Parameters

declaration ContentVisibilityDeclaration

The declaration record.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>, CancellationToken)

Sets the content visibility record for the authenticated user.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration, CancellationToken cancellationToken)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration>)

Sets the content visibility record for the authenticated user.

public Task<AtProtoHttpResult<PutRecordResult>> SetContentVisibilityDeclaration(AtProtoRepositoryRecord<ContentVisibilityDeclaration> declaration)

Parameters

declaration AtProtoRepositoryRecord<ContentVisibilityDeclaration>

The declaration record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetConversationDeclaration(string, string?)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(string, string?, CancellationToken)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites, CancellationToken cancellationToken)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(string, string?)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(string, string?, CancellationToken)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites, CancellationToken cancellationToken)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(string, string?)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(string, string?, CancellationToken)

Sets a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(string allowIncoming, string? allowGroupInvites, CancellationToken cancellationToken)

Parameters

allowIncoming string

Specifies whether incoming messages are allowed. Known values are specified in idunno.Bluesky.Chat.Actor.AllowIncoming

allowGroupInvites string?

Specifies whether group invites are allowed, or null to leave the preference unspecified. Known values are specified in idunno.Bluesky.Chat.Actor.AllowGroupInvites

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when allowIncoming is null or whitespace, or when allowGroupInvites is whitespace.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetConversationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a conversation declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetConversationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(NotificationAllowedFrom, CancellationToken)

Creates a notification declaration record for the current user. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> SetNotificationDeclaration(NotificationAllowedFrom notificationAllowedFrom, CancellationToken cancellationToken = default)

Parameters

notificationAllowedFrom NotificationAllowedFrom

Indicates who will be allowed to subscribe to post notifications for the current user.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a notification declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(NotificationAllowedFrom, CancellationToken)

Creates a notification declaration record for the current user. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> SetNotificationDeclaration(NotificationAllowedFrom notificationAllowedFrom, CancellationToken cancellationToken = default)

Parameters

notificationAllowedFrom NotificationAllowedFrom

Indicates who will be allowed to subscribe to post notifications for the current user.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a notification declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(NotificationAllowedFrom, CancellationToken)

Creates a notification declaration record for the current user. Requires authentication.

public Task<AtProtoHttpResult<CreateRecordResult>> SetNotificationDeclaration(NotificationAllowedFrom notificationAllowedFrom, CancellationToken cancellationToken = default)

Parameters

notificationAllowedFrom NotificationAllowedFrom

Indicates who will be allowed to subscribe to post notifications for the current user.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<CreateRecordResult>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration>, CancellationToken)

Update a notification declaration record for the current user. Requires authentication.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> SetNotificationDeclaration(AtProtoRepositoryRecord<Declaration> declaration, CancellationToken cancellationToken = default)

Parameters

declaration AtProtoRepositoryRecord<Declaration>

The declaration record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when declaration is null.

AuthenticationRequiredException

Thrown when the current session is not authenticated.

SetNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> SetNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SetNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> SetNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SetNotificationPreferences(Preferences, CancellationToken)

Sets the current user's notification preferences.

public Task<AtProtoHttpResult<Preferences>> SetNotificationPreferences(Preferences preferences, CancellationToken cancellationToken = default)

Parameters

preferences Preferences

The notification preferences to set.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Preferences>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when preferences is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile, or its Value is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

SetProfile(Profile, CancellationToken)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The profile to create from or update to

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(Profile)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile)

Parameters

profile Profile

The profile to create from or update to

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile, or its Value is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

SetProfile(Profile, CancellationToken)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The profile to create from or update to

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(Profile)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile)

Parameters

profile Profile

The profile to create from or update to

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile, or its Value is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(AtProtoRepositoryRecord<Profile>)

Updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The profile to create or update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

SetProfile(Profile, CancellationToken)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The profile to create from or update to

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

SetProfile(Profile)

Creates or updates the current user's profile.

public Task<AtProtoHttpResult<PutRecordResult>> SetProfile(Profile profile)

Parameters

profile Profile

The profile to create from or update to

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

StartUpload(long, string, string?, long?, int?, int?, CancellationToken)

Start a multipart video upload. The declared size is exact, while optional media properties are advisory and used only for early failure; the authoritative probe runs asynchronously after upload.

public Task<AtProtoHttpResult<StartUploadResponse>> StartUpload(long size, string mimeType, string? name = null, long? duration = null, int? width = null, int? height = null, CancellationToken cancellationToken = default)

Parameters

size long

Exact size, in bytes, of the complete upload-ready video file before it is split into parts.

mimeType string

Declared MIME type of the video.

name string?

An optional client-provided file name.

duration long?

An optional duration of the video in milliseconds.

width int?

An optional width of the video in pixels.

height int?

An optional height of the video in pixels.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StartUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when agent is not authenticated.

StartUpload(long, string, string?, long?, int?, int?, CancellationToken)

Start a multipart video upload. The declared size is exact, while optional media properties are advisory and used only for early failure; the authoritative probe runs asynchronously after upload.

public Task<AtProtoHttpResult<StartUploadResponse>> StartUpload(long size, string mimeType, string? name = null, long? duration = null, int? width = null, int? height = null, CancellationToken cancellationToken = default)

Parameters

size long

Exact size, in bytes, of the complete upload-ready video file before it is split into parts.

mimeType string

Declared MIME type of the video.

name string?

An optional client-provided file name.

duration long?

An optional duration of the video in milliseconds.

width int?

An optional width of the video in pixels.

height int?

An optional height of the video in pixels.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StartUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when agent is not authenticated.

StartUpload(long, string, string?, long?, int?, int?, CancellationToken)

Start a multipart video upload. The declared size is exact, while optional media properties are advisory and used only for early failure; the authoritative probe runs asynchronously after upload.

public Task<AtProtoHttpResult<StartUploadResponse>> StartUpload(long size, string mimeType, string? name = null, long? duration = null, int? width = null, int? height = null, CancellationToken cancellationToken = default)

Parameters

size long

Exact size, in bytes, of the complete upload-ready video file before it is split into parts.

mimeType string

Declared MIME type of the video.

name string?

An optional client-provided file name.

duration long?

An optional duration of the video in milliseconds.

width int?

An optional width of the video in pixels.

height int?

An optional height of the video in pixels.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<StartUploadResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when agent is not authenticated.

Unblock(Handle, CancellationToken)

Unblocks the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unblock(Did, CancellationToken)

Unblocks the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unblock(Handle, CancellationToken)

Unblocks the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unblock(Did, CancellationToken)

Unblocks the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unblock(Handle, CancellationToken)

Unblocks the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unblock(Did, CancellationToken)

Unblocks the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unblock(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UnblockModList(AtUri, CancellationToken)

Removes the block on the actors in the specified moderation list, by deleting the block record the authenticated user holds against the list. Requires authentication.

public Task<AtProtoHttpResult<DeleteResult>> UnblockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnblockModList(AtUri, CancellationToken)

Removes the block on the actors in the specified moderation list, by deleting the block record the authenticated user holds against the list. Requires authentication.

public Task<AtProtoHttpResult<DeleteResult>> UnblockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnblockModList(AtUri, CancellationToken)

Removes the block on the actors in the specified moderation list, by deleting the block record the authenticated user holds against the list. Requires authentication.

public Task<AtProtoHttpResult<DeleteResult>> UnblockModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the moderation list of actors to unblock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

ArgumentException

Thrown when listUri does not point to a list record.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Unfollow(Handle, CancellationToken)

Unfollows the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unfollow(Did, CancellationToken)

Unfollows the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unfollow(Handle, CancellationToken)

Unfollows the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unfollow(Did, CancellationToken)

Unfollows the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unfollow(Handle, CancellationToken)

Unfollows the specified handle.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Handle handle, CancellationToken cancellationToken = default)

Parameters

handle Handle

The idunno.AtProto.Handle of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when handle is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

Unfollow(Did, CancellationToken)

Unfollows the specified did.

public Task<AtProtoHttpResult<DeleteResult>> Unfollow(Did did, CancellationToken cancellationToken = default)

Parameters

did Did

The idunno.AtProto.Did of the actor to unfollow.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<DeleteResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when did is null.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UnlockConversation(string, CancellationToken)

Unlocks a conversation.

public Task<AtProtoHttpResult<ConversationView>> UnlockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to unlock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UnlockConversation(string, CancellationToken)

Unlocks a conversation.

public Task<AtProtoHttpResult<ConversationView>> UnlockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to unlock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UnlockConversation(string, CancellationToken)

Unlocks a conversation.

public Task<AtProtoHttpResult<ConversationView>> UnlockConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation to unlock.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or empty.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

Unmute(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Unmute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Unmute(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Unmute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

Unmute(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> Unmute(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActor(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActor(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActor(AtIdentifier, CancellationToken)

Unmutes the specified account. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActor(AtIdentifier actor, CancellationToken cancellationToken = default)

Parameters

actor AtIdentifier

The idunno.AtProto.AtIdentifier of the actor to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when actor is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActorList(AtUri, CancellationToken)

Unmutes the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActorList(AtUri, CancellationToken)

Unmutes the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteActorList(AtUri, CancellationToken)

Unmutes the specified list of accounts. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteActorList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteConversation(string, CancellationToken)

Unmutes the conversation identified by conversationId.

public Task<AtProtoHttpResult<ConversationView>> UnmuteConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UnmuteConversation(string, CancellationToken)

Unmutes the conversation identified by conversationId.

public Task<AtProtoHttpResult<ConversationView>> UnmuteConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UnmuteConversation(string, CancellationToken)

Unmutes the conversation identified by conversationId.

public Task<AtProtoHttpResult<ConversationView>> UnmuteConversation(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UnmuteModList(AtUri, CancellationToken)

Unmutes the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteModList(AtUri, CancellationToken)

Unmutes the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteModList(AtUri, CancellationToken)

Unmutes the specified moderation list. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteModList(AtUri listUri, CancellationToken cancellationToken = default)

Parameters

listUri AtUri

The idunno.AtProto.AtUri of the list of actors to unmute.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when listUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteThread(AtUri, CancellationToken)

Unmutes a thread. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteThread(AtUri, CancellationToken)

Unmutes a thread. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UnmuteThread(AtUri, CancellationToken)

Unmutes a thread. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UnmuteThread(AtUri rootUri, CancellationToken cancellationToken = default)

Parameters

rootUri AtUri

The idunno.AtProto.AtUri of the thread to unmute

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when rootUri is null.

AuthenticationRequiredException

Thrown when the agent is unauthenticated.

UpdateAllRead(string, CancellationToken)

Marks all conversations with the specified status as read.

public Task<AtProtoHttpResult<ulong?>> UpdateAllRead(string status, CancellationToken cancellationToken = default)

Parameters

status string

The status of the conversations to mark as read. Known values are held in idunno.Bluesky.Chat.ConversationStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ulong?>>

The task object representing the asynchronous operation.

Remarks

The result is null if the API call failed, which is distinct from a successful call which marked no conversations as read.

Exceptions

ArgumentException

Thrown when status is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateAllRead(string, CancellationToken)

Marks all conversations with the specified status as read.

public Task<AtProtoHttpResult<ulong?>> UpdateAllRead(string status, CancellationToken cancellationToken = default)

Parameters

status string

The status of the conversations to mark as read. Known values are held in idunno.Bluesky.Chat.ConversationStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ulong?>>

The task object representing the asynchronous operation.

Remarks

The result is null if the API call failed, which is distinct from a successful call which marked no conversations as read.

Exceptions

ArgumentException

Thrown when status is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateAllRead(string, CancellationToken)

Marks all conversations with the specified status as read.

public Task<AtProtoHttpResult<ulong?>> UpdateAllRead(string status, CancellationToken cancellationToken = default)

Parameters

status string

The status of the conversations to mark as read. Known values are held in idunno.Bluesky.Chat.ConversationStatus.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ulong?>>

The task object representing the asynchronous operation.

Remarks

The result is null if the API call failed, which is distinct from a successful call which marked no conversations as read.

Exceptions

ArgumentException

Thrown when status is null or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateDraft(DraftWithId, CancellationToken)

Updates a draft for the authenticated user.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateDraft(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The draft and ID to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftWithId is null.

UpdateDraft(DraftWithId, CancellationToken)

Updates a draft for the authenticated user.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateDraft(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The draft and ID to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftWithId is null.

UpdateDraft(DraftWithId, CancellationToken)

Updates a draft for the authenticated user.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateDraft(DraftWithId draftWithId, CancellationToken cancellationToken = default)

Parameters

draftWithId DraftWithId

The draft and ID to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the agent is not authenticated.

ArgumentNullException

Thrown when draftWithId is null.

UpdateJoinGroupRequestsRead(string, CancellationToken)

Marks all join requests as read for a specific conversation.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateJoinGroupRequestsRead(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UpdateJoinGroupRequestsRead(string, CancellationToken)

Marks all join requests as read for a specific conversation.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateJoinGroupRequestsRead(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UpdateJoinGroupRequestsRead(string, CancellationToken)

Marks all join requests as read for a specific conversation.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateJoinGroupRequestsRead(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UpdateList(AtUri, List, CancellationToken)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>, CancellationToken)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list, CancellationToken cancellationToken)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtUri, List)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtUri, List, CancellationToken)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>, CancellationToken)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list, CancellationToken cancellationToken)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtUri, List)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtUri, List, CancellationToken)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list, CancellationToken cancellationToken)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtProtoRepositoryRecord<List>, CancellationToken)

Updates the referenced list record.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtProtoRepositoryRecord<List> list, CancellationToken cancellationToken)

Parameters

list AtProtoRepositoryRecord<List>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 referenced idunno.Bluesky.Graph.List to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when list or its Uri, or the URI Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when the list Uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateList(AtUri, List)

Updates the list record referenced by its uri.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateList(AtUri uri, List list)

Parameters

uri AtUri

The idunno.AtProto.AtUri of the list record to update.

list List

The idunno.Bluesky.Graph.List to update the record with

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when uri or its Collection or RecordKey property is null.

ArgumentOutOfRangeException

Thrown when uri does not point to a list.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateNotificationSeenAt(DateTimeOffset?, CancellationToken)

Updates the date and time notifications were last seen for the current user. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateNotificationSeenAt(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateNotificationSeenAt(DateTimeOffset?, CancellationToken)

Updates the date and time notifications were last seen for the current user. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateNotificationSeenAt(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateNotificationSeenAt(DateTimeOffset?, CancellationToken)

Updates the date and time notifications were last seen for the current user. Requires authentication.

public Task<AtProtoHttpResult<EmptyResponse>> UpdateNotificationSeenAt(DateTimeOffset? seenAt = null, CancellationToken cancellationToken = default)

Parameters

seenAt DateTimeOffset?

An optional System.DateTimeOffset indicating when notifications were last checked.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdatePostGate(PostGate, CancellationToken)

Updates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate)

Updates the specified postGate record in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate)

Parameters

postGate PostGate

The postGate record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate, Cid?, CancellationToken)

Updates the specified postGate record in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetPostGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate, CancellationToken)

Updates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate)

Updates the specified postGate record in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate)

Parameters

postGate PostGate

The postGate record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate, Cid?, CancellationToken)

Updates the specified postGate record in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetPostGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate, CancellationToken)

Updates the specified postGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate)

Updates the specified postGate record in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate)

Parameters

postGate PostGate

The postGate record to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdatePostGate(PostGate, Cid?, CancellationToken)

Updates the specified postGate record in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdatePostGate(PostGate postGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

postGate PostGate

The postGate record to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetPostGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when postGate is null.

ArgumentException

Thrown when the postGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when the profile is not valid.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>)

Update the current user's idunno.Bluesky.Actor.Profile.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

UpdateProfile(Profile, Cid?, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, Cid? cid, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cid Cid?

The idunno.AtProto.Cid of the current profile record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when the profile is not valid.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>)

Update the current user's idunno.Bluesky.Actor.Profile.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

UpdateProfile(Profile, Cid?, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, Cid? cid, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cid Cid?

The idunno.AtProto.Cid of the current profile record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile, CancellationToken cancellationToken)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when the profile is not valid.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(AtProtoRepositoryRecord<Profile>)

Update the current user's idunno.Bluesky.Actor.Profile.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(AtProtoRepositoryRecord<Profile> profile)

Parameters

profile AtProtoRepositoryRecord<Profile>

The idunno.AtProto.Repo.AtProtoRepositoryRecord`1 to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

UpdateProfile(Profile, Cid?, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, Cid? cid, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cid Cid?

The idunno.AtProto.Cid of the current profile record.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile, CancellationToken)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile, CancellationToken cancellationToken)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateProfile(Profile)

Update the current user's idunno.Bluesky.Actor.Profile.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Put().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateProfile(Profile profile)

Parameters

profile Profile

The idunno.Bluesky.Actor.Profile to update with.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when profile is null.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateRead(string, string?, CancellationToken)

Marks a conversation, and optionally a message, as read.

public Task<AtProtoHttpResult<ConversationView>> UpdateRead(string conversationId, string? messageId = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to mark as read.

messageId string?

The message identifier in the conversation identified by conversationId to mark as read.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space or messageId is empty or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateRead(string, string?, CancellationToken)

Marks a conversation, and optionally a message, as read.

public Task<AtProtoHttpResult<ConversationView>> UpdateRead(string conversationId, string? messageId = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to mark as read.

messageId string?

The message identifier in the conversation identified by conversationId to mark as read.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space or messageId is empty or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateRead(string, string?, CancellationToken)

Marks a conversation, and optionally a message, as read.

public Task<AtProtoHttpResult<ConversationView>> UpdateRead(string conversationId, string? messageId = null, CancellationToken cancellationToken = default)

Parameters

conversationId string

The conversation identifier to mark as read.

messageId string?

The message identifier in the conversation identified by conversationId to mark as read.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<ConversationView>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or white space or messageId is empty or white space.

AuthenticationRequiredException

Thrown when the current agent is not authenticated.

UpdateStatus(AtProtoRepositoryRecord<Status>, CancellationToken)

Updates the status record for the authenticated user

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateStatus(AtProtoRepositoryRecord<Status> status, CancellationToken cancellationToken = default)

Parameters

status AtProtoRepositoryRecord<Status>

The status record to update. The record's URI authority must match the current user's decentralized identifier (DID).

cancellationToken CancellationToken

A cancellation token that can be used to cancel the asynchronous operation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

A task that represents the asynchronous update operation. The task result contains the outcome of the update, including the updated record information.

Exceptions

AuthenticationRequiredException

Thrown if the user is not authenticated when attempting to update the status.

ArgumentException

Thrown if the status record's URI authority is not a valid DID or does not match the current user's DID.

UpdateStatus(AtProtoRepositoryRecord<Status>, CancellationToken)

Updates the status record for the authenticated user

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateStatus(AtProtoRepositoryRecord<Status> status, CancellationToken cancellationToken = default)

Parameters

status AtProtoRepositoryRecord<Status>

The status record to update. The record's URI authority must match the current user's decentralized identifier (DID).

cancellationToken CancellationToken

A cancellation token that can be used to cancel the asynchronous operation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

A task that represents the asynchronous update operation. The task result contains the outcome of the update, including the updated record information.

Exceptions

AuthenticationRequiredException

Thrown if the user is not authenticated when attempting to update the status.

ArgumentException

Thrown if the status record's URI authority is not a valid DID or does not match the current user's DID.

UpdateStatus(AtProtoRepositoryRecord<Status>, CancellationToken)

Updates the status record for the authenticated user

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Get().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateStatus(AtProtoRepositoryRecord<Status> status, CancellationToken cancellationToken = default)

Parameters

status AtProtoRepositoryRecord<Status>

The status record to update. The record's URI authority must match the current user's decentralized identifier (DID).

cancellationToken CancellationToken

A cancellation token that can be used to cancel the asynchronous operation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

A task that represents the asynchronous update operation. The task result contains the outcome of the update, including the updated record information.

Exceptions

AuthenticationRequiredException

Thrown if the user is not authenticated when attempting to update the status.

ArgumentException

Thrown if the status record's URI authority is not a valid DID or does not match the current user's DID.

UpdateThreadGate(ThreadGate, CancellationToken)

Updates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The threadGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the threadGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate, Cid?, CancellationToken)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetThreadGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate, CancellationToken)

Updates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The threadGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the threadGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate, Cid?, CancellationToken)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetThreadGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate, CancellationToken)

Updates the specified threadGate record in the current user's repository.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The threadGate record to update.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the threadGate's RecordKey is null, or it does not point to a Post record or it does not belong to the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository.

public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UpdateThreadGate(ThreadGate, Cid?, CancellationToken)

Updates the specified idunno.Bluesky.Feed.Gates.ThreadGate in the current user's repository, replacing the record identified by swapRecord.

[UnconditionalSuppressMessage("Trimming", "IL2026:Members annotated with 'RequiresUnreferencedCodeAttribute' require dynamic access otherwise can break functionality when trimming application code", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
[UnconditionalSuppressMessage("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "All types are preserved in the JsonSerializerOptions call to Post().")]
public Task<AtProtoHttpResult<PutRecordResult>> UpdateThreadGate(ThreadGate threadGate, Cid? swapRecord, CancellationToken cancellationToken)

Parameters

threadGate ThreadGate

The idunno.Bluesky.Feed.Gates.ThreadGate to update.

swapRecord Cid?

The idunno.AtProto.Cid of the record the update is expected to replace, if the update should be conditional.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<PutRecordResult>>

The task object representing the asynchronous operation.

Remarks

Use idunno.Bluesky.BlueskyAgent.GetThreadGateRecord(idunno.AtProto.AtUri,System.Threading.CancellationToken) to read the idunno.AtProto.Cid of the record being replaced. The update fails rather than discarding a change made since the record was read.

Exceptions

ArgumentNullException

Thrown when threadGate is null.

ArgumentException

Thrown when the post the gate applies to does not point to a post record, its RecordKey is null, or it is not owned by the current user.

AuthenticationRequiredException

Thrown when the current session is unauthenticated.

UploadCaptions(byte[], string, CancellationToken)

Uploads a caption file to be referenced in an embedded video.

public Task<AtProtoHttpResult<Caption>> UploadCaptions(byte[] captionsAsBytes, string captionLanguage, CancellationToken cancellationToken = default)

Parameters

captionsAsBytes byte[]

The captions, as a byte array.

captionLanguage string

The language the captions are in.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Caption>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when captionsAsBytes is null.

ArgumentException

Thrown when captionLanguage is null or empty.

ArgumentOutOfRangeException

Thrown when captionsAsBytes is a zero length array.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadCaptions(byte[], string, CancellationToken)

Uploads a caption file to be referenced in an embedded video.

public Task<AtProtoHttpResult<Caption>> UploadCaptions(byte[] captionsAsBytes, string captionLanguage, CancellationToken cancellationToken = default)

Parameters

captionsAsBytes byte[]

The captions, as a byte array.

captionLanguage string

The language the captions are in.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Caption>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when captionsAsBytes is null.

ArgumentException

Thrown when captionLanguage is null or empty.

ArgumentOutOfRangeException

Thrown when captionsAsBytes is a zero length array.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadCaptions(byte[], string, CancellationToken)

Uploads a caption file to be referenced in an embedded video.

public Task<AtProtoHttpResult<Caption>> UploadCaptions(byte[] captionsAsBytes, string captionLanguage, CancellationToken cancellationToken = default)

Parameters

captionsAsBytes byte[]

The captions, as a byte array.

captionLanguage string

The language the captions are in.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<Caption>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when captionsAsBytes is null.

ArgumentException

Thrown when captionLanguage is null or empty.

ArgumentOutOfRangeException

Thrown when captionsAsBytes is a zero length array.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadImage(byte[], string, string, AspectRatio?, CancellationToken)

Uploads an image to be referenced in a post.

public Task<AtProtoHttpResult<EmbeddedImage>> UploadImage(byte[] imageAsBytes, string mimeType, string altText, AspectRatio? aspectRatio, CancellationToken cancellationToken = default)

Parameters

imageAsBytes byte[]

The image, as a byte array.

mimeType string

The mime type of the image. No validation is performed on this value.

altText string

The AltText (for accessibility) for the image.

aspectRatio AspectRatio?

The image's aspect ratio.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmbeddedImage>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when imageAsBytes or altText is null.

ArgumentOutOfRangeException

Thrown when imageAsBytes is empty.

ArgumentException

Thrown when mimeType is null or empty.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadImage(byte[], string, string, AspectRatio?, CancellationToken)

Uploads an image to be referenced in a post.

public Task<AtProtoHttpResult<EmbeddedImage>> UploadImage(byte[] imageAsBytes, string mimeType, string altText, AspectRatio? aspectRatio, CancellationToken cancellationToken = default)

Parameters

imageAsBytes byte[]

The image, as a byte array.

mimeType string

The mime type of the image. No validation is performed on this value.

altText string

The AltText (for accessibility) for the image.

aspectRatio AspectRatio?

The image's aspect ratio.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmbeddedImage>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when imageAsBytes or altText is null.

ArgumentOutOfRangeException

Thrown when imageAsBytes is empty.

ArgumentException

Thrown when mimeType is null or empty.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadImage(byte[], string, string, AspectRatio?, CancellationToken)

Uploads an image to be referenced in a post.

public Task<AtProtoHttpResult<EmbeddedImage>> UploadImage(byte[] imageAsBytes, string mimeType, string altText, AspectRatio? aspectRatio, CancellationToken cancellationToken = default)

Parameters

imageAsBytes byte[]

The image, as a byte array.

mimeType string

The mime type of the image. No validation is performed on this value.

altText string

The AltText (for accessibility) for the image.

aspectRatio AspectRatio?

The image's aspect ratio.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmbeddedImage>>

The task object representing the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when imageAsBytes or altText is null.

ArgumentOutOfRangeException

Thrown when imageAsBytes is empty.

ArgumentException

Thrown when mimeType is null or empty.

AuthenticationRequiredException

Thrown when the current session is not an authenticated session.

UploadPart(string, long, byte[], TimeSpan?, CancellationToken)

Upload one part of a multi-part upload started with idunno.Bluesky.BlueskyAgent.StartUpload(System.Int64,System.String,System.String,System.Nullable{System.Int64},System.Nullable{System.Int32},System.Nullable{System.Int32},System.Threading.CancellationToken). Parts are idempotent and may be retried or re-sent while the session is created. Each expected length is derived from the upload size and part size, and Content-Length must match exactly. ETags are never exposed to clients.

public Task<AtProtoHttpResult<UploadPartResponse>> UploadPart(string jobId, long part, byte[] bytes, TimeSpan? timeout = null, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to which this part belongs.

part long

The part number of the part being uploaded.

bytes byte[]

The bytes of the part being uploaded.

timeout TimeSpan?

An optional timeout for the request.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadPartResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

HttpRequestException

Thrown when the request fails due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

UploadPart(string, long, byte[], TimeSpan?, CancellationToken)

Upload one part of a multi-part upload started with idunno.Bluesky.BlueskyAgent.StartUpload(System.Int64,System.String,System.String,System.Nullable{System.Int64},System.Nullable{System.Int32},System.Nullable{System.Int32},System.Threading.CancellationToken). Parts are idempotent and may be retried or re-sent while the session is created. Each expected length is derived from the upload size and part size, and Content-Length must match exactly. ETags are never exposed to clients.

public Task<AtProtoHttpResult<UploadPartResponse>> UploadPart(string jobId, long part, byte[] bytes, TimeSpan? timeout = null, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to which this part belongs.

part long

The part number of the part being uploaded.

bytes byte[]

The bytes of the part being uploaded.

timeout TimeSpan?

An optional timeout for the request.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadPartResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

HttpRequestException

Thrown when the request fails due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

UploadPart(string, long, byte[], TimeSpan?, CancellationToken)

Upload one part of a multi-part upload started with idunno.Bluesky.BlueskyAgent.StartUpload(System.Int64,System.String,System.String,System.Nullable{System.Int64},System.Nullable{System.Int32},System.Nullable{System.Int32},System.Threading.CancellationToken). Parts are idempotent and may be retried or re-sent while the session is created. Each expected length is derived from the upload size and part size, and Content-Length must match exactly. ETags are never exposed to clients.

public Task<AtProtoHttpResult<UploadPartResponse>> UploadPart(string jobId, long part, byte[] bytes, TimeSpan? timeout = null, CancellationToken cancellationToken = default)

Parameters

jobId string

The job id of the upload to which this part belongs.

part long

The part number of the part being uploaded.

bytes byte[]

The bytes of the part being uploaded.

timeout TimeSpan?

An optional timeout for the request.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<UploadPartResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentOutOfRangeException

Thrown when a provided argument is out of the allowable range.

ArgumentException

Thrown when a provided argument is invalid.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

HttpRequestException

Thrown when the request fails due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

UploadVideo(string, byte[], string, CancellationToken)

Uploads video to be processed and stored.

public Task<AtProtoHttpResult<JobStatus>> UploadVideo(string fileName, byte[] media, string mimeType, CancellationToken cancellationToken = default)

Parameters

fileName string

The filename of the media.

media byte[]

The media to upload as bytes.

mimeType string

The MIME type of the media.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when fileName is null or empty, or when mimeType is null, whitespace, or is not a valid media type.

ArgumentNullException

Thrown when media is null.

ArgumentOutOfRangeException

Thrown when media is empty, or when mimeType is outside the allowable length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UploadVideo(string, byte[], string, CancellationToken)

Uploads video to be processed and stored.

public Task<AtProtoHttpResult<JobStatus>> UploadVideo(string fileName, byte[] media, string mimeType, CancellationToken cancellationToken = default)

Parameters

fileName string

The filename of the media.

media byte[]

The media to upload as bytes.

mimeType string

The MIME type of the media.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when fileName is null or empty, or when mimeType is null, whitespace, or is not a valid media type.

ArgumentNullException

Thrown when media is null.

ArgumentOutOfRangeException

Thrown when media is empty, or when mimeType is outside the allowable length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

UploadVideo(string, byte[], string, CancellationToken)

Uploads video to be processed and stored.

public Task<AtProtoHttpResult<JobStatus>> UploadVideo(string fileName, byte[] media, string mimeType, CancellationToken cancellationToken = default)

Parameters

fileName string

The filename of the media.

media byte[]

The media to upload as bytes.

mimeType string

The MIME type of the media.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<JobStatus>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when fileName is null or empty, or when mimeType is null, whitespace, or is not a valid media type.

ArgumentNullException

Thrown when media is null.

ArgumentOutOfRangeException

Thrown when media is empty, or when mimeType is outside the allowable length.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

WithdrawJoinGroupRequest(string, CancellationToken)

Withdraws a pending request to join a group.

public Task<AtProtoHttpResult<EmptyResponse>> WithdrawJoinGroupRequest(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation whose join request should be withdrawn.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

WithdrawJoinGroupRequest(string, CancellationToken)

Withdraws a pending request to join a group.

public Task<AtProtoHttpResult<EmptyResponse>> WithdrawJoinGroupRequest(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation whose join request should be withdrawn.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.

WithdrawJoinGroupRequest(string, CancellationToken)

Withdraws a pending request to join a group.

public Task<AtProtoHttpResult<EmptyResponse>> WithdrawJoinGroupRequest(string conversationId, CancellationToken cancellationToken = default)

Parameters

conversationId string

The ID of the conversation whose join request should be withdrawn.

cancellationToken CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Task<AtProtoHttpResult<EmptyResponse>>

The task object representing the asynchronous operation.

Exceptions

ArgumentException

Thrown when conversationId is null or whitespace.

AuthenticationRequiredException

Thrown when the agent is not authenticated.