What are you trying to accomplish?

https://secure.phabricator.com/book/phabcontrib/article/feature_requests/#describe-problems

What are you trying to accomplish?

Short answer: We aren't sure yet.

Long answer:

We are considering using Conduit to enhance our overall experience. However, right now:

1. We aren't sure what is possible with this API.
2. We can't be sure that behavior we find experimentally will continue to behave this way in the future.

Providing the described documentation allows us to start forming our plan for using the API with confidence that it will work as a medium- to long-term solution and reduces the work required to reach these goals once we form them. I believe this task (discovery/documentation) makes sense here because all Phabricator users are able to benefit from the result.

📝 I filed this request for a single, smaller API intentionally. I'm hoping the chosen granularity will prove to be a very simple task for someone already familiar with the way the call works.

This is a pretty old ticket, but if possible I'd like to add a use case:

I want to add a Project to a diff. Is this a property that can be set? If not, is therre an API that permits this?

@joncalhoun: That's not related to this ticket, and also not supported. You can add projects to Revisions, but not Diffs. There will be an API for projects on Revisions eventually, see T5873.

Sorry to necro an old thread, but I, too, am looking for information about this particular API method.

So, say I have a diff with an ID of 19. I want to add an arbitrary property to this diff, so I call differential.setdiffproperty with the following payload:

{
    "diff_id":19,
    "name":"test",
    "data":"test"
}

The Conduit response returns an error value of "null" and an errorMessage value of "null", so I assume it's been added.

When I call differential.querydiffs with the following payload :

{
   ids:[19]
}

I'm unable to find the property I've added anywhere within the diff data structure.

Am I fundamentally misunderstanding what a property means in this context, or am I querying for these diff properties incorrectly?

This is an arbitrary example. For a real-world example, I'm using a daemon to interface between Differential and another application and it'd be pretty convenient to store some metadata as properties of a diff review to prevent the daemon from performing the same work every time it's run. (Leaving comments, etc.) However, I felt that providing an arbitrary example would better illustrate the problem I'm having over an example that's a direct application of what I'm working on.